Chore: document code

[aslowwriter]

Even though the project is still young, I think the structure has been stable enough that we can start documenting the main bits of the code. This is just an issue to help me remember to do that.