finished structuring the documentation ... time to get the code working and flesh out docs with more information as appropriate