From ae2dccb215ee80e2e16f52e6eee8f22b440dd82d Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Thu, 18 Jun 2020 01:12:09 +0200
Subject: [PATCH] Document that some single char colors are shaded

---
 tutorials/colors/colors.py | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/tutorials/colors/colors.py b/tutorials/colors/colors.py
index 77935a9555ba..b8d81eee3f08 100644
--- a/tutorials/colors/colors.py
+++ b/tutorials/colors/colors.py
@@ -15,9 +15,11 @@
   case-insensitive);
 * a string representation of a float value in ``[0, 1]`` inclusive for gray
   level (e.g., ``'0.5'``);
-* one of ``{'b', 'g', 'r', 'c', 'm', 'y', 'k', 'w'}``, they are the single
-  character short-hand notations for blue, green, red, cyan, magenta, yellow,
-  black, and white.
+* one of the characters ``{'b', 'g', 'r', 'c', 'm', 'y', 'k', 'w'}``, which
+  are short-hand notations for shades of blue, green, red, cyan, magenta,
+  yellow, black, and white. Note that the colors ``'g', 'c', 'm', 'y'`` do not
+  coincide with the X11/CSS4 colors. Their particular shades were chosen for
+  better visibility of colored lines against typical backgrounds.
 * a X11/CSS4 color name (case-insensitive);
 * a name from the `xkcd color survey`_, prefixed with ``'xkcd:'`` (e.g.,
   ``'xkcd:sky blue'``; case insensitive);