What the heck: theming variables are changed without notification and proper documentation?

[promotion]
I recently went through HA’s frontend repo and looked for var(--. Here’s the results: