First pass over exported functions

[Shians]

Check exported functions and

• Check for adequate documentation
• Check examples are runnable
• Check arguments are consistent with other API within package
• Consider categorisation of function
• Consider if it should be made private

Check private functions and

• Consider if it is useful to expose
• Add "." prefix to indicate private
• Add any missing imports