general cleanup of recently added API docs, added optional permissions tutorial