wip explanations

docs/deposit/explanations/code-deposit.rst

@@ -30,7 +30,7 @@ asking SWH to archive a repository using the `save code now`_ feature are:
 - a deposited artifact is provided from one of the SWH partners which is regarded as a
   trusted authority,
 - a deposited artifact requires metadata properties describing the source code artifact,
-- a deposited artifact has a codemeta_ metadata entry attached to it,
+- a deposited artifact has a CodeMeta_ metadata entry attached to it,
 - a deposited artifact has the same visibility on the SWH Archive than a collected
   repository,
 - a deposited artifact can be searched with its provided url property on the SWH
@@ -41,4 +41,5 @@ asking SWH to archive a repository using the `save code now`_ feature are:
 .. _SWHID: https://docs.softwareheritage.org/devel/swh-model/persistent-identifiers.html#persistent-identifiers
 .. _vault: https://docs.softwareheritage.org/devel/swh-vault/index.html#swh-vault
 .. _save code now: https://archive.softwareheritage.org/save/
-.. _SWORD v2: http://swordapp.org/sword-v2/
\ No newline at end of file
+.. _SWORD v2: http://swordapp.org/sword-v2/
+.. _CodeMeta: https://codemeta.github.io/
\ No newline at end of file

docs/deposit/explanations/deposit.rst

 What's a deposit? Is it useful for me?
 ======================================
 
-TODO
\ No newline at end of file
+(TODO https://www.softwareheritage.org/2023/04/04/swhid-deposit-hal/)
+
+Source code is fragile; it can disappear. It is important to note that software source code has an essential role in research and should be archived properly, alongside data and publications. Software that was built for research as part of the open science ecosystem should be archived, referenced, described and cited.
+
+When depositing in Software Heritage you can describe a software artifact properly with specific metadata properties and it will be safely saved in the universal software archive.
+

docs/deposit/explanations/index.rst

+Explanations
+============
+
+.. toctree::
+   :maxdepth: 1
+
+   deposit.rst
+   why-metadata.rst
+   code-deposit.rst
+   metadata-only-deposit.rst
\ No newline at end of file

docs/deposit/explanations/metadata-only-deposit.rst

 What's a metadata-only deposit ?
 ================================
 
-TODO
\ No newline at end of file
+A client may wish to deposit only metadata about an origin or object already present in the Software Heritage archive.
+
+The metadata-only deposit is a special deposit where no content is provided and the data transferred to Software Heritage is only the metadata about an object in the archive.
\ No newline at end of file