The documentation so far is rather deficient and full of errors. If it doesn't answer your questions, consult the mailing list or ask us. If you think you can do better, we welcome patches.
You can download the documentation, although it will have a lot of broken links.
The references are often incomplete or wrong, especially in places that have been changing.