Improve documentation for semantic colors

[rafael-sepeda]

Thanks a lot for the great job and for pushing this topic forward. Really cool to finally have semantic colors live, especially in the documentation 📚. In order to make the new documentation for semantic colors a bit more transparent we need to add into the table in addition to the hex-values the brand-color references. Like

border.primary = Colors.AUTHENTIC_BLUE_200

Also since the Brand colors are not really functional/semantic I propose to separate them from Semantic colors.

Also @snapsnapturtle now, we have two color table for brand colors. How we can merge them in order to have one list of brand colors?

[snapsnapturtle]

In the next major version we want to replace the old Colors with the semantic/functional colors, so they will just be called Colors. For now, we wanted to keep both, so the teams can start using them without having to immediately migrate their existing codebase.

About the additional brand color reference: With a bit of trickery this might be doable (mapping the hex value back to the property).