diff --git a/lib/diaspora_federation/discovery/discovery.rb b/lib/diaspora_federation/discovery/discovery.rb
index 5ecb1d6..1f7f637 100644
--- a/lib/diaspora_federation/discovery/discovery.rb
+++ b/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)
diff --git a/lib/diaspora_federation/discovery/host_meta.rb b/lib/diaspora_federation/discovery/host_meta.rb
index 9346b6e..2de573e 100644
--- a/lib/diaspora_federation/discovery/host_meta.rb
+++ b/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
diff --git a/lib/diaspora_federation/validators/rules/tag_count.rb b/lib/diaspora_federation/validators/rules/tag_count.rb
index 6f100a8..3eb4120 100644
--- a/lib/diaspora_federation/validators/rules/tag_count.rb
+++ b/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)