Add API (function) docs

[ewels]

Now that we're opening up MultiQC internals for use in scripts (#2442), we should document how to use them.

We can write prose documentation in docs, but we should also use standardised docstring documentation. This will be easier to keep up to date and in sync and can be used as reference docs.

See also #2008