You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
In the docstrings, there are sections besides the standard sections used in numpy-style docstrings. For example, in sasparser.py:
General Metadata
----------------
filename
The name of the file from which data was parsed. This key
will not exist if data was not read from a file.
nbanks
The number of banks parsed.
bank
The chosen bank number.
sphinx-napoleon can't recognize these sections and will cause rendering issues.
Currently, they are all being handled as Attributes, so only the items like filename appear in the rendered documentation, not the headers like General Metadata. Maybe we want to find a way to better handle these special sections?