The documentation.py module#
Summary#
Documentation rule family. |
|
The doc/source structure exists. |
|
The Sphinx config exists. |
|
Numpydoc is enabled for NumPy-style API documentation. |
|
Intersphinx is enabled for cross-project documentation references. |
|
The index page has a getting started section. |
|
The index page has an API reference section. |
|
Gallery examples are recommended when a gallery extension is enabled. |
|
The Ansys Sphinx theme and PyAnsys branding are configured. |
|
Project and page titles are configured. |
|
Site author, copyright, and CNAME metadata are configured. |
|
The Ansys theme version switcher is configured. |
|
The index links required documentation pages with cards. |
|
Authored RST filenames use lowercase letters and hyphens. |
|
The getting-started page is provided as a root page or section index. |
|
The user-guide page is provided as a root page or section index. |
|
The API page is provided as a root page or section index. |
|
The examples page is provided as a root page or section index. |
|
The contribute page is provided as a root page or section index. |
|
The changelog root page exists. |
|
The getting-started section contains documentation files. |
|
The user-guide section contains documentation files. |
|
The API section contains documentation files. |
|
The examples section contains files. |
|
The contribute section contains documentation files. |
|
The user contributor guide is recommended. |
|
The documentarian contributor guide is recommended. |
|
The developer contributor guide is recommended. |
|
The interrogate hook checks docstring coverage. |
|
Sphinx AutoAPI or an API reference page is available. |
|
A cheatsheet is added to the documentation. |
Description#
Documentation structure and Sphinx configuration checks.
The checks cover the documentation source tree and layout, Sphinx configuration, index card links, authored RST filenames, gallery examples, and API docstring coverage tooling.
Module detail#
- documentation.DOCUMENTATION_QUALITY_RULES: tuple[type[Documentation], ...]#