diff --git a/lib/diaspora_federation/entities/relayable_retraction.rb b/lib/diaspora_federation/entities/relayable_retraction.rb
index 222d86d..bfd4a9b 100644
--- a/lib/diaspora_federation/entities/relayable_retraction.rb
+++ b/lib/diaspora_federation/entities/relayable_retraction.rb
@@ -17,6 +17,7 @@ module DiasporaFederation
     # is not checked, only parent_author_signature is checked.
     #
     # @see Validators::RelayableRetractionValidator
+    # @deprecated will be replaced with {Entities::Retraction}
     class RelayableRetraction < Entity
       # @!attribute [r] parent_author_signature
       #   Contains a signature of the entity using the private key of the author of a parent post
diff --git a/lib/diaspora_federation/entities/signed_retraction.rb b/lib/diaspora_federation/entities/signed_retraction.rb
index 111a429..49bb241 100644
--- a/lib/diaspora_federation/entities/signed_retraction.rb
+++ b/lib/diaspora_federation/entities/signed_retraction.rb
@@ -4,6 +4,7 @@ module DiasporaFederation
     # entity of post type ({Entities::StatusMessage})
     #
     # @see Validators::SignedRetractionValidator
+    # @deprecated will be replaced with {Entities::Retraction}
     class SignedRetraction < Entity
       # @!attribute [r] target_guid
       #   guid of a post to be deleted
diff --git a/lib/diaspora_federation/validators/relayable_retraction_validator.rb b/lib/diaspora_federation/validators/relayable_retraction_validator.rb
index 4b647af..e529f47 100644
--- a/lib/diaspora_federation/validators/relayable_retraction_validator.rb
+++ b/lib/diaspora_federation/validators/relayable_retraction_validator.rb
@@ -1,6 +1,7 @@
 module DiasporaFederation
   module Validators
     # This validates a {Entities::RelayableRetraction}
+    # @deprecated the {Entities::RelayableRetraction} will be replaced with {Entities::Retraction}
     class RelayableRetractionValidator < Validation::Validator
       include Validation
 
diff --git a/lib/diaspora_federation/validators/signed_retraction_validator.rb b/lib/diaspora_federation/validators/signed_retraction_validator.rb
index d8442b5..176471e 100644
--- a/lib/diaspora_federation/validators/signed_retraction_validator.rb
+++ b/lib/diaspora_federation/validators/signed_retraction_validator.rb
@@ -1,6 +1,7 @@
 module DiasporaFederation
   module Validators
     # This validates a {Entities::SignedRetraction}
+    # @deprecated the {Entities::RelayableRetraction} will be replaced with {Entities::Retraction}
     class SignedRetractionValidator < Validation::Validator
       include Validation