auth use cases documented
Updated docs, minor bugfixes