Enabling latest versions for Sphinx & Mkdocs builds¶

We are announcing the deprecation of building with older documentation tool versions by default.

Historically, Read the Docs installed a specific version based on the date your project was created. This caused odd issues where reimporting a project could change behavior, and caused users to continue using very old versions of build tools that weren’t supported by their authors. This was done to maintain backwards compatibility, but our platform now has robust support for defining a build environment, so we encourage you to pin your dependencies instead.

Starting on October 3rd Read the Docs will install the latest available version of MkDocs and Sphinx by default. If you want to use a different version, you can do this by pinning your dependencies.

version: 2

# Set the OS, Python version and other tools you might need
build:
  os: ubuntu-22.04
  tools:
    python: "3.11"

 python:
   install:
     - requirements: docs/requirements.txt

sphinx==6.2.1
sphinx-rtd-theme==1.2.2

version: 2

# Set the OS, Python version and other tools you might need
build:
  os: ubuntu-22.04
  tools:
    python: "3.11"

 python:
   install:
     - requirements: docs/requirements.txt

mkdocs==1.5.1