deisgn and features + readme

first draft of a couple house-keeping documents