Update tokens documentation.

[edonehoo]

Revisit our tokens docs to clarify details and expand on existing info. This includes:

• more detail about how to pick the semantic tokens.
• updated details how dark tokens work.
• checking for other areas where we can be more specific/helpful/accurate.