re #53 - Finalised API docs