Once the API has somewhat stabilized, we should check all docs for correctness and add an introductory usage example to the main page.