Re-sync code with readme.

[waldyrious]

Also add details for the last two sections.

[waldyrious]

This would probably be easier with a literate programming documentation flow. Not only that will give us a single source of truth (an no more opportunity for desynchronization), but the rendered view would be more readable on both sides. Something like Docco Viewer would probably work well.