Remove html extension from documentation

Makes URLs nicer by using dirhtml build instead of html. The effect
is that you will no longer see .html as part of URLs.

.config/dictionary.txt

@@ -45,6 +45,7 @@ delenv
 denormalize
 deps
 devel
+dirhtml
 dists
 distutils
 docstrings

.readthedocs.yml

@@ -8,7 +8,8 @@ version: 2
 
 # Build documentation in the docs/ directory with Sphinx
 sphinx:
-  builder: html
+  # keep dirhtml for nice URLs without .html extension
+  builder: dirhtml
   configuration: docs/conf.py
   fail_on_warning: true
 

README.rst

@@ -3,7 +3,7 @@
    :alt: PyPI version
 
 .. image:: https://img.shields.io/badge/Ansible--lint-rules%20table-blue.svg
-   :target: https://ansible-lint.readthedocs.io/en/latest/default_rules.html
+   :target: https://ansible-lint.readthedocs.io/en/latest/default_rules
    :alt: Ansible-lint rules explanation
 
 .. image:: https://img.shields.io/badge/Code%20of%20Conduct-black.svg
@@ -57,7 +57,7 @@ Authors
 ansible-lint was created by `Will Thames`_ and is now maintained as part of the
 `Ansible`_ by `Red Hat`_ project.
 
-.. _Contribution guidelines: https://ansible-lint.readthedocs.io/en/latest/contributing.html
+.. _Contribution guidelines: https://ansible-lint.readthedocs.io/en/latest/contributing
 .. _Will Thames: https://github.com/willthames
 .. _Ansible: https://ansible.com
 .. _Red Hat: https://redhat.com

docs/contributing.rst

@@ -47,4 +47,4 @@ to create a new rule by following the steps below:
   displayed correctly in them.
 
 .. _MetaTagValidRule: https://github.com/ansible-community/ansible-lint/blob/main/src/ansiblelint/rules/meta_no_tags.py
-.. _rules: https://ansible-lint.readthedocs.io/en/latest/default_rules.html
+.. _rules: https://ansible-lint.readthedocs.io/en/latest/default_rules

tox.ini

@@ -131,10 +131,11 @@ commands =
     . \
     "{envdir}/html"
 
-  # Build the html docs with Sphinx:
+  # Build the html docs with Sphinx. Keep `dirhtml` as we do not want .html
+  # extensions on URLs.
   {envpython} -m sphinx \
     -j auto \
-    -b html \
+    -b dirhtml \
     --color \
     -a \
     -n \