minor fixes
added some documentation