Configuration FileΒΆ
In addition to using the admin panel of your project to configure your project, you can use a configuration file in the root of your project. The configuration file can be named:
readthedocs.yml
readthedocs.yaml
.readthedocs.yml
.readthedocs.yaml
The main advantages of using a configuration file over the web interface are:
Settings are per version rather than per project.
Settings live in your VCS.
They enable reproducible build environments over time.
Some settings are only available using a configuration file
Tip
Using a configuration file is the recommended way of using Read the Docs.