add a readme to the document directory
WIP - commented out examples, working out calculated params