updated documentation
started working on the guts...