Glossary#
What is Sphinx?
Sphinx is a tool that makes it easy to create documentation. It supports various output formats including
html
, and has powerful extensions that to help keep your API documentation up to date.What is
reStructuredText
?A plaintext markup syntax and parser.
reStructuredText
files use the extension.rst
. Sphinx primarily parses.rst
files and generates files in your target format (likehtml
, or PDF).What is a
docstring
?A string literal specified in source code that is used to document a specific segment of code. Usually follows a specific format parsable by various tools, including Sphinx.
What is PyPI?
PyPI (pronounced Pie-‘P’-‘I’) is the Python Package Index (docs). It’s the default, global Python package mirror.
[Previous: Automating versioning](./10-automating-versioning.md){: .btn .float-left} [Next: Further reading](./12-further-reading.md){: .btn .btn-purple .float-right}