wip references

docs/deposit/references/api.rst

 API reference
 =============
 
-
-SWORD
------
-
-
-Deposit
--------
\ No newline at end of file
+.. warning::
+   TODO link to swh-deposit API doc

docs/deposit/references/cli.rst

 Command line interface reference
 ================================
 
+.. warning::
+   TODO link to swh-deposit CLI doc
\ No newline at end of file

docs/deposit/references/examples.rst

 Real-world examples / integrations
-==================================
\ No newline at end of file
+==================================
+
+HAL
+---
+
+.. thumbnail:: ../images/deposit-communication-SWHID-scenario-2.png
+
+| When depositing in HAL you can describe a software artifact properly with specific metadata properties and fetch export formats (e.g BibTeX .bib file) to facilitate citation. Furthermore the source code will be safely saved in the universal software archive, Software Heritage.
+
+https://www.softwareheritage.org/2023/04/04/swhid-deposit-hal/
+
+Zenodo
+------
+
+.. thumbnail:: ../images/Zenodo_SWH-1536x716.png
+
+| Here’s how it works: Code deposited in Zenodo is automatically archived in Software Heritage, the world’s largest software source code archive. Researchers get a Digital Object Identifier (DOI) for easy citation, while Software Heritage computes a Software Hash Identifier (SWHID) for ensuring the identification of the exact version that is used or mentioned, for reproducibility – a real code fingerprint. All of this takes place behind the scenes, streamlining the archiving process. Researchers can simply deposit code in Zenodo, and the rest is handled automatically.
+
+https://www.softwareheritage.org/2024/11/13/software-heritage-zenodo-integration/
\ No newline at end of file

docs/deposit/references/index.rst

+References
+==========
+
+.. toctree::
+   :maxdepth: 1
+
+   workflow.rst
+   metadata.rst
+   examples.rst
+   api.rst
+   cli.rst
+   package.rst
\ No newline at end of file

docs/deposit/references/metadata.rst

 Metadata
-========
\ No newline at end of file
+========
+
+
+Intrinsic metadata
+-------------------
+
+
+
+
+
+
+Extrinsic metadata
+-------------------
+
+extrinsic-metadata-specification
\ No newline at end of file