Change to dirhtml builder (#667)

.readthedocs.yml

@@ -12,6 +12,7 @@ build:
 
 sphinx:
   configuration: conf.py
+  builder: dirhtml
 
 python:
   install:

README.md

@@ -22,7 +22,7 @@ To do so, follow these steps:
    $ nox -s docs
    ```
 
-This should create a local environment in a `.nox` folder, build the documentation (as specified in the `noxfile.py` configuration), and the output will be in `_build/html`.
+This should create a local environment in a `.nox` folder, build the documentation (as specified in the `noxfile.py` configuration), and the output will be in `_build/dirhtml`.
 
 To build live documentation that updates when you update local files, run the following command:
 

noxfile.py

@@ -2,7 +2,7 @@
 
 nox.options.reuse_existing_virtualenvs = True
 
-build_command = ["-b", "html", ".", "_build/html"]
+build_command = ["-b", "dirhtml", ".", "_build/dirhtml"]
 
 
 @nox.session

reference/documentation/environment.md

@@ -82,7 +82,7 @@ This differs slightly depending on the repository, but it usually works like thi
 3. **Build the documentation with Sphinx**. Finally, you can build the documentation locally with Sphinx using a command like so:
 
    ```shell
-   sphinx-build docs docs/_build/html
+   sphinx-build -b dirhtml docs docs/_build/dirhtml
    ```
 
 See [the Sphinx documentation](https://www.sphinx-doc.org/en/master/) for more details.