add some trivial docstrings
some simple stubins of datastructures
real basic changes to executable structure