diff --git a/docs/guidelines.md b/docs/guidelines.md
index 34e7c3b3df..3a6ab1a7f1 100644
--- a/docs/guidelines.md
+++ b/docs/guidelines.md
@@ -40,9 +40,11 @@ for example `ic_event_control_24dp.xml`.
 Load vector drawables [using compat loading](https://medium.com/androiddevelopers/using-vector-assets-in-android-apps-4318fd662eb9)
 so they work (tinting) and do not crash (gradients) on all supported releases:
 
-- `Button`: use `ViewTools.setVectorDrawableTop`, ...
+- `Button`: use `ViewTools.setVectorDrawableTop`, ... (uses `AppCompatResources.getDrawable()`)
 - `ImageView`, `ImageButton`: use `app:srcCompat`
 - `TextView`: use `app:drawableStartCompat`, `app:drawableTopCompat`, ...
+- **Optionally** if the drawable is just a color
+- **Not** for app widget layouts as the system initializes them
 
 ## Click listeners