User documentation for the deposit service

related to swh-deposit#4655

Reasons for this MR:

1. The deposits mechanisms are no longer be limited to the swh-deposit package (see swh-coarnotify),
2. The organization of the current swh-deposit documentation could be improved to match more closely the needs of our user and, most importantly, prospects

Key-points of this MR:

• make a new user oriented documentation for our deposit service (not a documentation on the swh-deposit software)
• following diataxis principles
• avoid content duplication especially for references

Our immediate goal is to leverage this documentation to showcase the deposit service(s) effectively to prospective partners.

Changes

• the new doc will live in swh-docs/users/deposit
• its entrypoints are:
  • a new lvl2 chapter on the landing page under Archive source code called Deposit artefacts and/or metadata leading to the /deposit path
  • a new entry is /user
• the documentation will follow the plan laid out in swh-deposit#4655

Screenshots

A live preview is also available on https://polite-meerkat-9b0f00.netlify.app/user/deposit/

swh-docs landing page changes

deposit services index

docs/deposit/howto/deposit-code.rst

@@ -5,7 +5,7 @@ Requisites
 ----------
 
 1. Have your account credentials and prepared artefacts at hand.
-2. Either the CLI installed or a tool to make API calls (curl_, HTTPie_, etc.)
+2. Either the CLI installed or a tool to make API calls (curl, HTTPie, etc.)
 
 Make a code deposit
 -------------------
@@ -13,40 +13,48 @@ Make a code deposit
 One shot
 ^^^^^^^^
 
-.. tabs::
-   .. code-tab:: CLI
+.. tab-set::
+
+  .. tab-item:: CLI
+
+    .. code-block:: console
+
       swh deposit ...
-   .. code-tab:: API
+
+  .. tab-item:: API
+
+    .. code-block:: console
+
       # Note the 'In-Progress: false' header
       curl -i -u <username>:<pass> \
-            -F "file=@deposit.json;type=application/zip;filename=payload" \
-            -F "atom=@atom-entry.xml;type=application/atom+xml;charset=UTF-8" \
-            -H 'In-Progress: false' \
-            -XPOST https://deposit.softwareheritage.org/1/hal/
+           -F "file=@deposit.json;type=application/zip;filename=payload" \
+           -F "atom=@atom-entry.xml;type=application/atom+xml;charset=UTF-8" \
+           -H 'In-Progress: false' \
+           -XPOST https://deposit.softwareheritage.org/1/hal/
 
 
 Partial
 ^^^^^^^
 
-
 Check its status
 ----------------
 
 Your deposit will go :doc:`through multiple steps </references/workflow>` before appearing in the archive, You can check the status of your deposit ang get its SWHID :
 
-.. tabs::
+.. tab-set::
 
-   .. code-tab:: CLI
-         swh deposit status ...
+  .. tab-item:: CLI
 
-   .. code-tab:: API
+    .. code-block:: console
+
+      swh deposit ...
 
-        curl -i -u hal:<pass> \
-            -F "file=@deposit.json;type=application/zip;filename=payload" \
-            -F "atom=@atom-entry.xml;type=application/atom+xml;charset=UTF-8" \
-            -H 'In-Progress: false' \
-            -XPOST https://deposit.softwareheritage.org/1/hal/
+  .. tab-item:: API
 
+    .. code-block:: console
 
-:: _curl: https://curl.se/
-:: _HTTPie: https://httpie.io/
\ No newline at end of file
+      curl -i -u hal:<pass> \
+           -F "file=@deposit.json;type=application/zip;filename=payload" \
+           -F "atom=@atom-entry.xml;type=application/atom+xml;charset=UTF-8" \
+           -H 'In-Progress: false' \
+           -XPOST https://deposit.softwareheritage.org/1/hal/