API documentation fixes, final draft of authorization chapter and some small design tweaks.