documentation updated

will need to eventually do some unit tests.