From 39bb424bc205b7e86119d5905a9dd0fc015263b3 Mon Sep 17 00:00:00 2001
From: marianomartin <marianomartin@google.com>
Date: Mon, 1 Jun 2020 11:33:49 -0400
Subject: [PATCH] Update color theming docs with a brief section about naming.

PiperOrigin-RevId: 314134688
---
 docs/theming/Color.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/docs/theming/Color.md b/docs/theming/Color.md
index b169c91b9..a739d433b 100644
--- a/docs/theming/Color.md
+++ b/docs/theming/Color.md
@@ -89,6 +89,27 @@ style and set the mapping yourself:
 You would then apply the `Widget.MyApp.MyButton` style to any buttons you want
 to have this alternate style.
 
+## Defining your app colors
+
+When creating your app colors, that will be used in the theme, do not use the
+same name as the color slot:
+
+```xml
+<resources>
+  <color name="color_primary">...</color>
+  <color name="color_surface">...</color>
+</resources>
+```
+
+Instead use literal names relevant to the RGB value. Eg:
+
+```xml
+<resources>
+  <color name="brand_blue">...</color>
+  <color name="brand_gray">...</color>
+</resources>
+```
+
 ## Theming All Instances of One Component
 
 If, however, you want to change the default styles for **all** instances of a