mozilla-services
Revisit documentation needs for tokenserver and its function
One pain point on the tokenserver incident was that we lack referential documentation on the entire system.
It’s possible that documenting the pruning scripts could be sufficient, but we should revisit what documentation should exist for tokenserver, and enumerate the capabilities that tokenserver provides us/justify its existence.
┆Issue is synchronized with this Jira Task
➤ Taddes Korris commented:
General documentation relevant to Tokenserver is now within the repo, following Rust mdbook standard. Added section on general overview, link to the tokenserver purge script docs made recently, added Tokenserver API docs. From here, the docs will be easier to find, to maintain and we are less likely to have outdated source material to persist (which has gotten us into trouble before.)