Finish standardisation of docstrings

Question

Finish standardisation of docstrings

Closed this issue 2 years ago · 3 comments

Need to run Sphinx and/or liaise with Clive to settle on the working docstring format and standardise the language / descriptions used.

Any changes to be retroactively applied to current function docstrings

Answer 1 · 2022-10-20T10:34:24.000Z

This need to be done earlier rather than later otherwise we will lose some time to do it again. The documentation might be useful for us as well (for me definitely as I am not very familiar with all functions).

Answer 2 · 2022-11-02T14:15:24.000Z

Sphinx is now running on my test branch. Still need to fill out docstrings for the remaining functions and tidy them up retroactively before settling on the new (numpy) docstring standard

Answer 3 · 2022-11-09T17:09:31.000Z

Considered closed with commit #184 - Numpy docstring standard works with Sphinx.