Minimal documentation

[Zearin]

From the README:

The source code is not heavily documented - we aim to write self-explanatory, simple code instead. If you find something hard to understand, that's a bug! Feel free to open a bug report.

The problem with “self-explanatory, simple code” instead of documentation is that not everyone can read JavaScript at the level of fluency.

Since this project is supposed to be a minimalist implementation (including being here for others to write implementations in other languages), I think the project could do with a little more documentation. At the very least, 1 or 2 sentences at the beginning of each file, describing what the file contains, and its general role in the bigger picture.

[aslakhellesoy]

I see your point. I'm busy in the next 4-6 weeks so don't hold your breath.