Guides
======

These guides will help walk you through specific use cases
related to Read the Docs itself, documentation tools like Sphinx and MkDocs
and how to write successful documentation.


Sphinx & MkDocs how-to guides
-----------------------------

These guides will help you get the most out of your documentation authoring tool
whether that is Sphinx or MkDocs.

.. toctree::
    :maxdepth: 1

    adding-custom-css
    custom-404-page
    intersphinx
    manage-translations
    mkdocs-old-versions
    pdf-non-ascii-languages
    remove-edit-buttons
    vcs


Read the Docs how-to guides
---------------------------

These guides will help you customize or tune aspects of the Read the Docs build environment.

.. toctree::
    :maxdepth: 1

    autobuild-docs-for-pull-requests
    build-notifications
    build-using-too-many-resources
    technical-docs-seo-guide
    canonical
    conda
    environment-variables
    feature-flags
    google-analytics
    searching-with-readthedocs
    sitemaps
    specifying-dependencies
    wipe-environment

Guides
======

These guides will help walk you through specific use cases
related to Read the Docs itself, documentation tools like Sphinx and MkDocs
and how to write successful documentation.


Sphinx & MkDocs how-to guides
-----------------------------

These guides will help you get the most out of your documentation authoring tool
whether that is Sphinx or MkDocs.

.. toctree::
    :maxdepth: 1

    adding-custom-css
    custom-404-page
    intersphinx
    manage-translations
    mkdocs-old-versions
    pdf-non-ascii-languages
    remove-edit-buttons
    vcs


Read the Docs how-to guides
---------------------------

These guides will help you customize or tune aspects of the Read the Docs.

.. toctree::
    :maxdepth: 1

    autobuild-docs-for-pull-requests
    build-notifications
    build-using-too-many-resources
    technical-docs-seo-guide
    canonical
    conda
    environment-variables
    feature-flags
    google-analytics
    searching-with-readthedocs
    sitemaps
    specifying-dependencies
    wipe-environment

Remove 'build environment' from guides
Remove 'build environment' from guides

There are guides that are about customizing other aspects as well.
