ci: set the readthedocs config to be used for all platform providers

Author: 56kyle

…bitbucket' %}.readthedocs.yml{% endif %} …iecutter.project_name}}/.readthedocs.yml{{cookiecutter.project_name}}/{% if cookiecutter.repository_provider == 'bitbucket' %}.readthedocs.yml{% endif %} renamed to {{cookiecutter.project_name}}/.readthedocs.yml {{cookiecutter.project_name}}/{% if cookiecutter.repository_provider == 'bitbucket' %}.readthedocs.yml{% endif %} renamed to {{cookiecutter.project_name}}/.readthedocs.yml

@@ -92,10 +92,4 @@ Distributed under the terms of the **{{ cookiecutter.license }}** license. See [
 <!-- Reference Links -->
 [cookiecutter-robust-python]: https://github.com/56kyle/cookiecutter-robust-python
 
-{% if cookiecutter.repository_provider == 'github' %}
-[documentation]: https://{{ cookiecutter.repository_path.split('/')[0] }}.github.io/{{ cookiecutter.project_name.replace('_', '-') }}/
-{% elif cookiecutter.repository_provider == 'gitlab' %}
-[documentation]: https://{{ cookiecutter.repository_path.replace('/', '.') }}.gitlab.io/{{ cookiecutter.project_name.replace('_', '-') }}/
-{% else %}
 [documentation]: https://{{ cookiecutter.project_name.replace('_', '-') }}.readthedocs.io/
-{% endif %}

{{cookiecutter.project_name}}/README.md

@@ -249,7 +249,27 @@ build-python:
     - if: $CI_COMMIT_BRANCH == "main"
     - if: $CI_PIPELINE_SOURCE == "web"
 
-# Documentation build (GitLab Pages)
+# Documentation build validation (ReadTheDocs handles hosting)
+build-docs:
+  stage: build
+  <<: *uv-cache
+  script:
+    - uvx nox -s build-docs
+  after_script:
+    - uv cache prune --ci
+  artifacts:
+    paths:
+      - docs/_build/html/
+    expire_in: 5 days
+  <<: *on-merge-requests-and-main
+  changes:
+    - "docs/**/*"
+    - "src/**/*.py"
+    - "noxfile.py"
+    - "pyproject.toml"
+    - ".gitlab-ci.yml"
+
+# Documentation build (GitLab Pages - fallback/mirror)
 pages:
   stage: build
   <<: *uv-cache