> Sounds like this project may be intending to write one, but is there any existing documentation on syntax colouring that goes beyond "what we thought looked nice"?

I tried to do something link this with a color scheme for VSCode https://marketplace.visualstudio.com/items?itemName=narenran... . Some highlights:

* Warm Colors are used for action keywords - throw, return in programming languages, links in Markdown files.

* Cold colors are used for definitions - Function names, variable values etc.

* Muted neutral colors are used for punctuation, comments, and anything else which detracts from the code.

I've been meaning to write a more detailed post on this (as well as an update), but comments/feedback welcome!