Logo

First steps

  • Read the Docs tutorial
  • Getting Started with Sphinx
  • Getting Started with MkDocs
  • Importing Your Documentation
  • Choosing Between Our Two Platforms

Features

  • Main Features
  • Configuration File
  • VCS Integrations
  • Custom Domains
  • Versioned Documentation
  • Downloadable Documentation
  • Documentation Hosting Features
  • Server Side Search
  • Traffic Analytics
  • Preview Documentation from Pull Requests
  • Build Notifications and Webhooks
  • Security log and auditing
  • Connecting Your VCS Account
  • Build process
  • Build customization
  • Build troubleshooting
  • Environment Variables
  • Status Badges
  • Site Support
  • Frequently Asked Questions

How-to Guides

  • Guides for documentation authors
  • Guides for project administrators
  • Guides for developers and designers
  • Read the Docs for Science
  • Example projects

Advanced features

  • Subprojects
  • Single Version Documentation
  • Flyout Menu
  • Feature Flags
  • Localization of Documentation
  • User-defined Redirects
  • Automatic Redirects
  • Automation Rules
  • Canonical URLs
  • Public API

Read the Docs for Business

  • Read the Docs for Business
  • Organizations
  • Project Privacy Level
  • Sharing
  • Single Sign-On
  • How to manage your Read the Docs for Business subscription

About Read the Docs

  • Security
  • DMCA Takedown Policy
  • Policy for Abandoned Projects
  • Policy for Unofficial and Unmaintained Projects
  • Changelog
  • About Read the Docs
  • Read the Docs Team
  • Read the Docs Open Source Philosophy
  • The Story of Read the Docs
  • Advertising
  • Sponsors of Read the Docs
  • Legal Documents and Policies
  • Developer Documentation
  • Glossary
  • Google Summer of Code
Read the Docs user documentation
  • Guides
  • Edit on GitHub

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.

  • Guides for documentation authors
    • Cross-referencing with Sphinx
    • Link to external projects (Intersphinx)
    • How to use Jupyter notebooks in Sphinx
    • Migrate from rST to MyST
  • Guides for project administrators
    • Technical Documentation Search Engine Optimization (SEO) Guide
    • Manage Translations for Sphinx projects
    • Hide a Version and Keep its Docs Online
    • Deprecating Content
    • Sphinx PDFs with Unicode
    • Manually Importing Private Repositories
    • Setup Build Notifications
  • Guides for developers and designers
    • Installing Private Python Packages
    • Using Private Git Submodules
    • Adding Custom CSS or JavaScript to Sphinx Documentation
    • Reproducible Builds
    • Embedding Content From Your Documentation
    • Conda Support
    • Removing “Edit on …” Buttons from Documentation
    • My Build is Using Too Many Resources
    • Adding “Edit Source” links on your Sphinx theme
    • Setup Build Notifications

© Copyright Read the Docs, Inc & contributors. Revision 5ab0da07.

Built with Sphinx using a theme provided by Read the Docs.
Read the Docs v: stable
Versions
latest
stable
diataxis-main
Downloads
pdf
html
epub
On Read the Docs
Project Home
Builds