Documentation fixes

I fixed some documentation while going through the project to learn how things worked. Mostly minor things except:

* I made the MIT license explicit in the README,
* I aligned the code in `main.commented` to that of `main.c`.

I have other clean-up patches waiting for this PR to be merged.

Cheers,