@@ -64,7 +64,7 @@ jobs:
           enable-cache: true
       - name: Install dependencies
         run: uv sync --group doc
-      - run: uv run sphinx-build doc build/sphinx/html
+      - run: uv run sphinx-build -W --keep-going doc build/sphinx/html
 
   nix:
     runs-on: ubuntu-latest
 
@@ -9,7 +9,7 @@ Changed
 - scim2-client 0.8.0 and scim2-tester 0.3.0 are now the minimum supported versions.
 - Requests are performed with `httpx2 <https://github.com/pydantic/httpx2>`_ instead of
   httpx, following the scim2-client 0.8 engine rename.
-- :ref:`query` only sends the ``attributes`` and ``excludedAttributes`` parameters when a
+- :ref:`reference:query` only sends the ``attributes`` and ``excludedAttributes`` parameters when a
   single resource is queried, as :rfc:`RFC7644 §3.4.1 <7644#section-3.4.1>` defines those
   as the sole parameters of that request. ``--start-index``, ``--count``, ``--filter``,
   ``--sort-by`` and ``--sort-order`` are refused in that case, instead of being sent along.
@@ -19,7 +19,7 @@ Fixed
 - Server SCIM errors and invalid request payloads are reported as readable messages
   instead of a traceback. scim2-client 0.8 raises the scim2-models exceptions for those,
   which do not belong to its own exception hierarchy.
-- The :ref:`test` ``--dont-check-status-code`` and ``--dont-check-content-type`` options
+- The :ref:`reference:test` ``--dont-check-status-code`` and ``--dont-check-content-type`` options
   were not applied on the client.
 
 [0.2.4] - 2026-01-25
@@ -41,16 +41,16 @@ Added
 
 Added
 ^^^^^
-- The :ref:`test` command returns 1 in case of errors.
-- Added :ref:`test` ``--dont-check-content-type`` and ``--dont-check-status-code`` options.
+- The :ref:`reference:test` command returns 1 in case of errors.
+- Added :ref:`reference:test` ``--dont-check-content-type`` and ``--dont-check-status-code`` options.
 
 [0.2.1] - 2024-12-04
 --------------------
 
 Added
 ^^^^^
 - Display server discovery step network connections.
-- Support loading server configuration objects in :class:`~scim2_models.ListResponses`.
+- Support loading server configuration objects in :class:`~scim2_models.ListResponse`.
 
 [0.2.0] - 2024-12-03
 --------------------
 
@@ -50,6 +50,8 @@
 pygments_style = "sphinx"
 todo_include_todos = True
 toctree_collapse = False
+nitpicky = True
+autosectionlabel_prefix_document = True
 suppress_warnings = ["autosectionlabel.changelog"]
 
 intersphinx_mapping = {
 
@@ -88,11 +88,11 @@ You can store those data locally and reuse them for future command runs thanks t
 Query and search resources
 --------------------------
 
-Use the :ref:`query` and :ref:`search` commands to look for resources.
-:ref:`query` performs a `GET` request on the resources endpoint, while :ref:`search` performs a `POST` request on the ``/.search`` endpoint.
-Both commands take similar options such as :option:`--count <scim-query.--count>` or :option:`--attributes <scim-query.--attributes>`.
+Use the :ref:`reference:query` and :ref:`reference:search` commands to look for resources.
+:ref:`reference:query` performs a `GET` request on the resources endpoint, while :ref:`reference:search` performs a `POST` request on the ``/.search`` endpoint.
+Both commands take similar options such as :option:`--count <scim-query --count>` or :option:`--attribute <scim-query --attribute>`.
 An exhaustive list of options can be found on the :doc:`reference`.
-:ref:`query` can also take a :option:`RESOURCE_TYPE <scim-query.RESOURCE_TYPE>` and a :option:`ID <scim-query.ID>` parameters.
+:ref:`reference:query` can also take a :option:`RESOURCE_TYPE <scim-query RESOURCE_TYPE>` and a :option:`ID <scim-query ID>` parameters.
 
 - If none are set, all the resources of the server are queried.
 
@@ -109,7 +109,7 @@ An exhaustive list of options can be found on the :doc:`reference`.
           "itemsPerPage": 50,
           "Resources": [...]
       }
-- If :option:`RESOURCE_TYPE <scim-query.RESOURCE_TYPE>` is set and :option:`ID <scim-query.ID>` is unset, all the resource of the kind passed in parameter are returned.
+- If :option:`RESOURCE_TYPE <scim-query RESOURCE_TYPE>` is set and :option:`ID <scim-query ID>` is unset, all the resource of the kind passed in parameter are returned.
 
   .. code-block:: console
       :caption: Querying all the users from the server.
@@ -146,10 +146,11 @@ An exhaustive list of options can be found on the :doc:`reference`.
           },
           "userName": "bjensen@example.com"
       }
+
 Create and replace resources
 ----------------------------
 
-Use the :ref:`create` and :ref:`replace` commands to edit resources.
+Use the :ref:`reference:create` and :ref:`reference:replace` commands to edit resources.
 
 Options for those commands are dynamically generated, depending on the resource attributes available on the server.
 For instance, for the :class:`~scim2_models.User` resource, you have a ``--user-name`` option.
@@ -178,7 +179,7 @@ You can have a look at the exhaustive list of options by running ``scim create u
 Delete resources
 ----------------
 
-The :ref:`delete` command allows you to delete resources.
+The :ref:`reference:delete` command allows you to delete resources.
 
 .. code-block:: console
    :caption: Deletion of an user.
@@ -188,7 +189,7 @@ The :ref:`delete` command allows you to delete resources.
 Perform a SCIM compliance test
 ------------------------------
 
-The :ref:`test` command runs a series of resource creation, edition and deletions to check that your server complies with the SCIM specifications.
+The :ref:`reference:test` command runs a series of resource creation, edition and deletions to check that your server complies with the SCIM specifications.
 See the :doc:`scim2-tester documentation <scim2_tester:index>` for more details on which tests are performed.
 
 .. code-block:: console
@@ -211,7 +212,7 @@ JSON input
 scim2-cli will also read input data from the standard input.
 Use this to send custom payloads to the SCIM server.
 
-When user with :ref:`query` and :ref:`search`, the input value must be a JSON representation of a :class:`~scim2_models.SearchRequest` object:
+When user with :ref:`reference:query` and :ref:`reference:search`, the input value must be a JSON representation of a :class:`~scim2_models.SearchRequest` object:
 
 .. code-block:: console
    :caption: Search of an user by passing a custom payload.
@@ -227,7 +228,7 @@ When user with :ref:`query` and :ref:`search`, the input value must be a JSON re
         "Resources": [...]
     }
 
-When used with :ref:`create` and :ref:`replace`, no subcommand is needed and the endpoint is guessed from the payload.
+When used with :ref:`reference:create` and :ref:`reference:replace`, no subcommand is needed and the endpoint is guessed from the payload.
 
 .. code-block:: console
    :caption: Creation of an user by passing a custom payload.
 
@@ -160,8 +160,8 @@ uv_resolution = "lowest-direct"
 [tool.tox.env.doc]
 dependency_groups = ["doc"]
 commands = [
-    ["sphinx-build", "--builder", "html", "doc", "build/sphinx/html"],
-    ["sphinx-build", "--builder", "man", "doc", "build/sphinx/html"],
+    ["sphinx-build", "-W", "--keep-going", "--builder", "html", "doc", "build/sphinx/html"],
+    ["sphinx-build", "-W", "--keep-going", "--builder", "man", "doc", "build/sphinx/html"],
 ]
 
 [tool.tox.env.coverage]
 
@@ -96,7 +96,6 @@ def query_cli(
                 f"Unknown resource type '{resource_type}. Available values are: {ok_values}'"
             ) from exc
 
-    # ServiceProviderConfig is a singleton endpoint, so it is reached without an id.
     single_resource = bool(id) or resource_type is ServiceProviderConfig
     listing_options = [
         name
 
@@ -10,9 +10,6 @@
 DOC_URL = "https://scim2-cli.readthedocs.io/"
 INDENTATION_SIZE = 4
 
-# scim2-client raises its own exceptions for transport and response issues, and
-# scim2-models SCIM exceptions for invalid request payloads and server errors.
-# The two hierarchies are unrelated, so both must be caught.
 SCIM_EXCEPTIONS = (SCIMClientException, SCIMException)