Open russelldj opened 11 months ago
It might be useful to explore pydoctest as a way to help with this.
It would be useful for the docs pages to have some more summary content. We should look into whether there are more opportunities to include this in the actual files (e.g. can you have a file-level docstring?) and if not include it in the docs folder.
I've gotten lazy with some recent PRs and haven't made sure all the functions/methods have docstrings. This should be addressed. A lower-priority task would be ensuring that all docstrings are up to date and reflect the current arguments. I personally use VSCode autoDocstring to do the templating.