docs: replace all hard coded links with extlinks

Author: 56kyle

docs/conf.py

@@ -65,11 +65,14 @@
     "bitbucket-pipelines": ("https://support.atlassian.com/bitbucket-cloud/docs/get-started-with-bitbucket-pipelines/%s", None),
     "black": ("https://black.readthedocs.io/%s", None),
     "build": ("https://pypa-build.readthedocs.io/%s", None),
+    "cobertura": ("https://cobertura.github.io/cobertura/xml.html%s", None),
     "commitizen": ("https://commitizen-tools.github.io/commitizen/%s", None),
+    "conventional-commits": ("https://www.conventionalcommits.org/en/v1.0.0/%s", None),
     "coverage.py": ("https://coverage.readthedocs.io/%s", None),
     "cruft": ("https://cruft.github.io/cruft/%s", None),
     "docker-compose": ("https://docs.docker.com/compose/%s", None),
     "docker": ("https://docs.docker.com/%s", None),
+    "docker-install": ("https://docs.docker.com/engine/install/%s", None),
     "flake8": ("https://flake8.pycqa.org/%s", None),
     "flit": ("https://flit.pypa.io/%s", None),
     "github-actions": ("https://docs.github.com/en/actions/%s", None),
@@ -79,6 +82,7 @@
     "helm": ("https://helm.sh/%s", None),
     "invoke": ("https://www.pyinvoke.org/%s", None),
     "isort": ("https://pycqa.github.io/isort/%s", None),
+    "junit": ("https://llg.cubic.org/docs/junit/%s", None),
     "just": ("https://just.systems/%s", None),
     "maturin": ("https://maturin.rs/%s", None),
     "mkdocs": ("https://www.mkdocs.org/%s", None),
@@ -90,11 +94,13 @@
     "pip": ("https://pip.pypa.io/%s", None),
     "pip-tools": ("https://pip-tools.readthedocs.io/%s", None),
     "podman": ("https://podman.io/%s", None),
+    "podman-install": ("https://podman.io/docs/installation/%s", None),
     "poethepoet": ("https://github.com/nat-n/poethepoet/%s", None),
     "poetry": ("https://python-poetry.org/%s", None),
     "pre-commit": ("https://pre-commit.com/%s", None),
     "pydocstyle": ("https://www.pydocstyle.org/%s", None),
     "pylint": ("https://pylint.pycqa.org/%s", None),
+    "pypi-trusted-publishers": ("https://docs.pypi.org/trusted-publishers/%s", None),
     "pyright": ("https://github.com/microsoft/pyright/%s", None),
     "pytest": ("https://docs.pytest.org/%s", None),
     "pytest-pytest-cov": ("https://pytest-cov.readthedocs.io/%s", None),
@@ -108,6 +114,7 @@
     "tox": ("https://tox.readthedocs.io/%s", None),
     "twine": ("https://twine.readthedocs.io/%s", None),
     "uv": ("https://docs.uv.dev/%s", None),
+    "uv-install": ("https://docs.astral.sh/uv/installation/%s", None),
     "venv": ("https://docs.python.org/3/library/venv%s", None),
     "virtualenv": ("https://virtualenv.pypa.io/%s", None),
     "yapf": ("https://github.com/google/yapf/%s", None)

docs/getting-started-template-contributing.md

@@ -8,7 +8,7 @@ To contribute to the template, you will need:
 
 1.  **Git**: For version control.
 2.  **Python 3.9+**: We recommend using a supported Python version.
-3.  **uv**: Our chosen dependency manager (see [Dependency Management (02)](topics/02_dependency-management.md)). Install `uv` globally or in a base environment following the official [uv installation guide](https://docs.astral.sh/uv/installation/).
+3.  **uv**: Our chosen dependency manager (see [Dependency Management (02)](topics/02_dependency-management.md)). Install `uv` globally or in a base environment following the official [uv installation guide](uv-install-documentation).
 4.  **Docker or Podman**: Required for testing the containerization aspects of the generated template (see [Container Build (11)](topics/11_container-build.md), [Dev Containers (17)](topics/17_dev-containers.md)).
 5.  **Task Automation Tools**: The template itself uses a `noxfile.py` to manage its own development and documentation build workflows. Install `nox`:
     ```bash

docs/quickstart.md

@@ -12,8 +12,8 @@ Make sure you have these installed:
 
 - **Python 3.9+** (or your chosen template version).
 - **Git**.
-- **uv**: Our chosen dependency manager. Install it [officially](https://docs.astral.sh/uv/installation/).
-- **Docker or Podman**: If you plan to work with containers (most web apps will need this). Install [Docker](https://docs.docker.com/engine/install/) or [Podman](https://podman.io/docs/installation/).
+- **uv**: Our chosen dependency manager. Install it [officially](uv-install-documentation).
+- **Docker or Podman**: If you plan to work with containers (most web apps will need this). Install [Docker](docker-install-documentation) or [Podman](podman-install-documentation).
 
 ## 2. Create Your Project
 

docs/usage.md

@@ -48,7 +48,7 @@ Your project uses [:term:`uv`](uv-documentation) to manage dependencies, environ
   # Manual activation: source .venv/bin/activate (Linux/macOS), .venv\Scripts\activate.bat (Windows cmd)
   ```
 
-Refer to the [uv documentation](https://docs.astral.sh/uv/cli/) for more advanced usage.
+Refer to the [uv documentation](uv-documentation) for more advanced usage.
 
 ## Code Quality Checks
 
@@ -130,7 +130,7 @@ Use [:term:`Commitizen`](commitizen-documentation) ([Topic 12](topics/12_task-au
   ```bash
   uvx nox -s release -- [major|minor|patch] # e.g., uvx nox -s release -- minor
   ```
-  Follow the prompts. Requires following [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/). Pushing the resulting tag often triggers the CD pipeline.
+  Follow the prompts. Requires following [Conventional Commits](conventional-commits-documentation). Pushing the resulting tag often triggers the CD pipeline.
 
 ## Advanced Usage & Customization
 

docs/workflow/index.md

@@ -64,13 +64,13 @@ The workflow extends seamlessly to automation platforms using the Task Automatio
     - Sets up the necessary Python version(s) and environment.
     - Installs [:term:`uv`](uv-documentation) and [:term:`Nox`](nox-documentation).
     - Runs key Task Automation commands: `uvx nox -s check`, `uvx nox -s test`.
-    - Collects reports ([JUnit XML](https://llg.cubic.org/docs/junit/), [Cobertura XML](https://cobertura.github.io/cobertura/xml.html)).
+    - Collects reports ([JUnit XML](junit-documentation), [Cobertura XML](cobertura-documentation)).
     - Reports status back to the version control platform.
       This process runs tests and checks reliably across the matrix of Python versions defined in the `noxfile.py` and potentially operating systems supported by the CI platform.
 
 2.  **Continuous Deployment / Delivery (CD):** Triggered by events like successful CI runs on the main branch or Git tags. The CD configuration ([CD Orchestration (14)](../topics/14_cd_orchestration.md)) is also a thin orchestration layer:
     - Sets up the environment.
-    - Manages secure credentials ([API tokens](https://docs.pypi.org/trusted-publishers/) for PyPI, registry secrets).
+    - Manages secure credentials ([API tokens](pypi-trusted-publishers-documentation) for PyPI, registry secrets).
     - Runs Task Automation commands to build artifacts: `uvx nox -s build:package` ([Packaging Build (09)](../topics/09_packaging-build.md)), `uvx nox -s build:container` ([Container Build (11)](../topics/11_container-build.md)).
     - Runs Task Automation commands to publish artifacts: `uvx nox -s publish` ([Packaging Publishing (10)](../topics/10_packaging-publish.md)), or uses Docker CLI to push container images.