version: 2

sphinx:
  # This should not fail on errors so that we can view the rendered Read The Docs
  # pages even on errors.
  # We have a separate build process which fails on errors and shows all
  # the errors in one go.
  # This can be re-enable once RTD is updated with https://github.com/readthedocs/readthedocs.org/issues/7116
  fail_on_warning: False
  configuration: docs/conf.py

# We don't proofread all the output formats, and we don't know if anyone really
# uses some of them.  Is anyone actually printing the docs out as a PDF?  If a
# particular format is useful to someone let's let them download it.  If
# dubiously-used formats start causing build errors that are difficult to debug
# (i.e. PDF, EPub) feel free to disable them if necessary, but HTMLZip is an
# offline archive of the actual docs website that everyone uses most frequently
# and should be kept working; if it's breaking then probably something is wrong
# with the website as well.
formats: all

build:
  os: ubuntu-22.04
  tools:
    python: "3.11"

python:
  install:
    - method: pip
      path: .
      extra_requirements:
        - dev-release
