minor design fixes
add docs infrastructure
more docs