[PATCH b4 00/21] docs: various fixes + migration from definition lists to glossaries for config settings

[Quentin Schulz <foss+kernel@0leil.net>]

This makes use of rST version admonitions for config settings in
anticipation to make each config setting a term such that we can
cross-reference them easily and have an anchor in the output for easier
link sharing. Then it migrates current "verbatim cross-references" to
actual cross-references using :term:.

This adds version admonitions for sections applicable only to some
versions and for program arguments.

This separates the b4.thanks-pr-template and b4.thanks-am-template as
well as include verbatim the example templates from the repo (for
b4.shazam-merge-template) instead of vaguely mentioning them.

This fixes various typos.

This adds external links to manpages.

This adds missing info on settings/options version deprecation and
addition.

This sorts the config settings per section (glossary), both by enforcing
it at the directive level and also in the text.

This adds missing b4.linkmask reference to b4 am/shazam --add-link.

I haven't changed the program options into a glossary, but this is
something I could do if there's interest.

Note: ``b4 send`` seems to be picking up
``Signed-off-by: Your Name <your.name@example.com>`` from the git
context in patch 11 and adds it to Cc recipients for some reason??

Signed-off-by: Quentin Schulz <quentin.schulz@cherry.de>
---
Quentin Schulz (21):
      docs: maintainer: ty: fix incorrect config name for templates
      docs: prep: add info on when range-diff-opts was added
      docs: diff: add info on when range-diff-opts was added
      docs: contributor: send: fix sendmail typo
      docs: config: separate b4.thanks-pr-template and b4.thanks-am-template
      docs: use rST version admonitions for command options
      docs: use versionadded admonition for sections
      docs: maintainer: use deprecated admonition
      docs: config: provide link to git-config conf file documentation
      docs: config: fix discrepancy between example strings
      docs: move sentence-ending dots from within the last quoted string to outside
      docs: config: add missing dot at end of sentence
      docs: config: provide link to patatt
      docs: config: provide link to git-send-email manpage
      docs: config: fix double colon typo
      docs: config: provide example content for template files
      docs: config: use rST version admonitions
      docs: config: migrate definition lists to glossaries
      docs: config: sort glossaries
      docs: cross-reference config options with :term:
      docs: maintainer: am-shazam: cross-reference b4.linkmask for --add-link

 docs/config.rst               | 615 +++++++++++++++++++++++-------------------
 docs/contributor/prep.rst     |  49 +++-
 docs/contributor/send.rst     |  34 ++-
 docs/maintainer/am-shazam.rst |  12 +-
 docs/maintainer/diff.rst      |  16 +-
 docs/maintainer/mbox.rst      |  12 +-
 docs/maintainer/pr.rst        |  13 +-
 docs/maintainer/ty.rst        |   8 +-
 8 files changed, 437 insertions(+), 322 deletions(-)
---
base-commit: 38c61e3d0a1b2b14ee75f3d763362fd63e162849
change-id: 20260203-misc-docs-1dca48ffccc0

Best regards,
--  
Quentin Schulz <quentin.schulz@cherry.de>