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.