Caution
You're viewing documentation for an unstable version of Scylla Sphinx Theme. Switch to the latest stable version.
Here are some basic concepts you should know before adding the doc toolchain to a project.
We recommend using reStructuredText markup language to write documentation. Additionally, the toolchain supports Markdown.
The tool we use to convert restructuredText and Markdown to HTML. Sphinx comes with directives and extensions, which add additional options for formatting the text.
All Scylla documentation projects share a theme to have a common look and feel. In addition, Scylla Sphinx Theme preinstalls a set of custom functionalities to make them available for all projects.
We use the third-party extension sphinx-multiversion to build docs for different versions.
Hosts the code and docs source files of Scylla’s projects.
Hosts the HTML version of the docs generated by Sphinx.
Builds and deploys the documentation to GitHub Pages whenever new content is in the GitHub repository default branch.
All the repositories deploy the documentation automatically except the repository scylla-docs, which is deployed manually.
Builds a preview site for the docs every time someone sends a pull request that updates the docs folder.