feat(platform): add documentation for scoped API tokens

[tobice]

We're adding public facing documentation for a new feature, tokens with limited permissions, aka scoped tokens.

Full context is available in the design doc.