Welcome to the official documentation repository for Oppia where documentation is built. This repository is connected to the Read the Docs platform which hosts Oppia’s user guide.
Read the Docs is an open source hosting platform for Sphinx-generated documentation.
Sphinx is a documentation generator and Sphinx documents are written in a markup language called reStructuredText (reST for short).
From a high-level perspective, the workflow for writing documentation in Sphinx looks like this:
- Write the documentation in plain text files using reST.
- Build the documentation (HTML output) using Sphinx on the command line.
- Push docs to Oppia’s creator-documentation repository (or submit a pull request).
- Read the Docs automatically builds and updates documentation from the repository.
Contributions are welcome from the community! Changes are accepted through pull requests.
Consult the wiki to learn how you can set things up and contribute to the documentation.