write more docs
documenation updates. minimal attempt to make it markdown-ish