WIP: public API and usage notes.