Tidy up docs, and add guide to token API