Complete list of patches in documentation

Add minimal documentation to all patches that had none yet.

datalad_next/patches/cli_configoverrides.py

@@ -1,3 +1,10 @@
+"""Post DataLad config overrides CLI/ENV as GIT_CONFIG items in process ENV
+
+This enables their propagation to any subprocess. This include the
+specification of overrides via the ``datalad -c ...`` option of the
+main CLI entrypoint.
+"""
+
 from datalad.config import _update_from_env as _update_from_datalad_env
 from datalad.cli.helpers import _parse_overrides_from_cmdline
 

datalad_next/patches/commanderror.py

@@ -1,11 +1,16 @@
+"""Improve ``CommandError`` rendering
+
+Without this patch that overwrites ``__repr__``, it would use
+``RuntimeError``'s variant and ignore all additional structured information
+except for ``.msg`` -- which is frequently empty and confuses with a
+`CommandError('')` display.
+"""
+
 from datalad.runner.exception import CommandError
 
 
 def commanderror_repr(self) -> str:
     return self.to_str()
 
 
-# without overwriting __repr__ it would use RuntimeError's variant
-# with ignore all info but `.msg` which will be empty frequently
-# and confuse people with `CommandError('')`
 CommandError.__repr__ = commanderror_repr

datalad_next/patches/create_sibling_gitlab.py

@@ -1,5 +1,7 @@
-"""
+"""Streamline user experience
 
+Discontinue advertizing the ``hierarchy`` layout, and better explain
+limitations of the command.
 """
 
 import datalad.distributed.create_sibling_gitlab as mod_gitlab

docs/source/patches.rst

@@ -9,14 +9,18 @@ Patches that are automatically applied to DataLad when loading the
    :toctree: generated
 
    annexrepo
+   cli_configoverrides
+   commanderror
    common_cfg
    configuration
    create_sibling_ghlike
+   create_sibling_gitlab
    customremotes_main
    distribution_dataset
    interface_utils
    push_optimize
    push_to_export_remote
-   test_keyring
-   siblings
    run
+   siblings
+   test_keyring
+   update