Adding more documentation

[onel]

Super interesting project, I would love to contribute some documentation to it if you guys are open to contributions.

I see the API docs site covers some important parts so I can start with some reference docs in the code and move up from there.