ansys/pyansys-dev-guide

General example only referenced on pages but not part of a toctree

PipKat opened this issue · 0 comments

Description of the modifications

The pyvista_example.py file in C:\AnsysDev\GitRepos\PyAnsys\dev-guide\examples is not included in a toctree. It is referenced in the last paragraph in the "Examples" topic on the Documenting page and in the first bullet in the "Set up examples" topic on the Use Sphinx-Gallery page. It shows up in the breadcrumb trail like this:

The breadcrumb for the link from the Documenting page looks like this:
image

The breadcrumb for the link from the Use Sphinx-Gallery page looks like this:
image

Sphinx doesn't complain about this because the source file is located outside of the doc directory. We need to decide where to put the example content so that it's part of a toctree. It can be part of the "How-To>Documenting" section or Content writing>Content in examples section. Information about examples can then be consolidating in the decided location.

Useful links and references

https://dev.docs.pyansys.com/how-to/documenting.html
https://dev.docs.pyansys.com/content-writing/examples-writers/sphinx-gallery.html