better documentation

lib/diaspora_federation/discovery/discovery.rb

@@ -7,6 +7,7 @@ module DiasporaFederation
       # @return [String] the diaspora ID of the account
       attr_reader :diaspora_id
 
+      # create a discovery class for the diaspora-id
       # @param [String] diaspora_id the diaspora id to discover
       def initialize(diaspora_id)
         @diaspora_id = clean_diaspora_id(diaspora_id)

lib/diaspora_federation/discovery/host_meta.rb

@@ -19,6 +19,7 @@ module DiasporaFederation
     class HostMeta
       private_class_method :new
 
+      # create a new host-meta instance
       # @param [String] webfinger_url the webfinger-url
       def initialize(webfinger_url)
         @webfinger_url = webfinger_url

lib/diaspora_federation/validators/rules/tag_count.rb

@@ -8,6 +8,7 @@ module Validation
       # @return [Hash] params
       attr_reader :params
 
+      # create a new rule for a maximum tag count validation
       # @param [Hash] params
       # @option params [Fixnum] :maximum maximum allowed tag count
       def initialize(params)