Docs update

Fixes #247

@giffmex - I appreciate that I haven’t fixed everything you mentioned