remove some development cruft
add some documentation