added lots of comments

everyone love documentation right? fixes #8
switched planning document fileformat