Tools for documentation¶
Packages¶
For user documentation, contributor guides, and communications content, we use:
For developer API documentation (especially for JupyterLab js repos), we use:
Source file formats¶
We use the following input source file formats when developing Sphinx documentation:
- reStructuredText (
.rst
) - Markdown (
.md
) - Notebook (
.ipynb
)
A modern code editor should be used. Many are available including Atom, SublimeText, gedit, vim, emacs. Atom is a good choice for new contributors.
Sphinx themes¶
Our projects use the following themes:
- sphinx_rtd_theme (currently used by Jupyter projects)
- jupyter_sphinx_theme (used by ipywidgets)
Git and Github Resources¶
If this is your first time working with Github or git, you can leverage the following resources to learn about the tools.