Ensure docs are up to date

[Perseudonymous]

Function documentation is written separately to the functions. It would be easier to keep these in sync if that bit of the docs was automated from doc strings