Doctools without configuration file ( / mkdocs.yml) are deprecated

Historically Read the Docs has created a file for Sphinx projects and a mkdocs.yml file for MkDocs projects that don’t provide one, to make onboarding easier. This has been confusing a lot our users in different ways and we will remove the auto-creation of a default Sphinx/MkDocs configuration file for projects that don’t have one on August 28th. To avoid unexpected behavior or your documentation builds failing, you should add a configuration file to your project by this date.

The auto-creation of a default configuration file will be completely removed on August 28th. Add a to your projects before this date to avoid unexpected build failures.

You can find a good example of a basic configuration file in our example projects:

Please contact us about any issues you have regarding change.