update docs

this aims to reflect my recent changes to the module and the dev process.