I suggest we leave this in the Wiki for now. We have a lot of documentation in the Wiki that should move to ReadTheDocs eventually, but we don't yet have any structure or organization for that. I hope to work on that before our 3.0 release, but I don't think it should hold up this ticket (let me know if you disagree).
If you can determine that it can be moved to something like ReadTheDocs now, then let's move it. But if we'll need to make significant changes first, let's make the changes and then move it over.
Done
Pinned fields
Click on the next to a field label to start pinning.
There are two main parts to this ticket:
Document how the auth service works in general and how to use it
Document auth design with service-level (root access) tokens and user-level (user-based access) tokens ()
We should put something in the README in the auth service. For something more detailed, we might need to create a wiki doc.