Documentation updates remain uncommited
There are 2 open PRs with plenty of documentation text, and we should sort it out before shipping 0.8. I am opening this Issue so that it doesnt get forgotten. 
- [ ] https://github.com/kaitai-io/kaitai_struct_doc/pull/7
- [ ] https://github.com/kaitai-io/kaitai_struct_doc/pull/5

I am asssigning @GreyCat because he seems to be the ultimate authority here and noone else will merge it on his own. 
