Add notes about "versionadded" and "deprecated" admonitions

Author: HavokInspiration

en/contributing/documentation.rst

@@ -339,7 +339,7 @@ Notes and warnings
 
 There are often times when you want to inform the reader of an important tip,
 special note or a potential hazard. Admonitions in sphinx are used for just
-that. There are three kinds of admonitions.
+that. There are five kinds of admonitions.
 
 * ``.. tip::`` Tips are used to document or re-iterate interesting or important
  information. The content of the directive should be written in complete
@@ -350,6 +350,12 @@ that. There are three kinds of admonitions.
 * ``.. warning::`` Warnings are used to document potential stumbling blocks, or
  information pertaining to security. The content of the directive should be
  written in complete sentences and include all appropriate punctuation.
+* ``.. versionadded:: X.Y.Z`` "Version added" admonitions are used to display notes
+ specific to new features added at a specific version, ``X.Y.Z`` being the version on
+ which the said feature was added.
+* ``.. deprecated:: X.Y.Z`` As opposed to "version added" admonitions, "deprecated"
+ admonition are used to notify of a deprecated feature, ``X.Y.Z`` being the version on
+ which the said feature was deprecated.
 
 All admonitions are made the same::
 
@@ -374,6 +380,14 @@ Samples
 
  It could be dangerous.
 
+.. versionadded:: 2.6.3
+
+ This awesome feature was added on version 2.6.3
+
+.. deprecated:: 2.6.3
+
+ This old feature was deprecated on version 2.6.3
+
 
 .. meta::
  :title lang=en: Documentation

fr/contributing/documentation.rst

@@ -358,7 +358,7 @@ Notes et avertissements
 
 Il y a souvent des fois où vous voulez informer le lecteur d'une astuce
 importante, une note spéciale ou un danger potentiel. Les avertissements
-dans sphinx sont justement utilisés pour cela. Il y a trois types
+dans sphinx sont justement utilisés pour cela. Il y a cinq types
 d'avertissements.
 
 * ``.. tip::`` Les astuces sont utilisées pour documenter ou réitérer des
@@ -373,6 +373,14 @@ d'avertissements.
  potentiellement dangereux, ou des informations relatives à la sécurité. Le
  contenu de la directive doit être écrite en phrases complètes et inclure
  toute la ponctuation appropriée.
+* ``.. versionadded:: X.Y.Z`` Les avertissements "ajouté en version X.Y.Z" sont
+ utilisés pour spécifier l'ajout de fonctionnalités dans une version spécifique,
+ ``X.Y.Z`` étant la version à laquelle l'ajout de la fonctionnalité en question a
+ eu lieu
+* ``.. deprecated:: X.Y.Z`` À la différence des avertissements "ajouté en version",
+ les avertissements "déprécié en version" servent à indiquer la dépréciation d'une
+ fonctionnalité à une version précise, ``X.Y.Z`` étant la version à laquelle le retrait
+ de la fonctionnalité en question a eu lieu
 
 Tous les avertissements sont faits de la même façon::
 
@@ -398,6 +406,14 @@ Exemples
 
  Cela pourrait être dangereux.
 
+.. versionadded:: 2.6.3
+
+ Cette super fonctionnalité a été ajoutée en version 2.6.3
+
+.. deprecated:: 2.6.3
+
+ Cette vieille fonctionnalité a été dépréciée en version 2.6.3
+
 
 .. meta::
  :title lang=fr: Documentation