Added some more comments in code fragments.

Author: phaesler

docs/style_howto_color_ramp.rst

@@ -73,7 +73,7 @@ arthimetic operators like `+ - / *` and parentheses for precedence.
 
     ndvi_unidirection_cfg = {
         "index_expression": "(nir-red)/(nir+red)",
-        "mpl_ramp": "ocean_r",
+        "mpl_ramp": "ocean_r",    #  ocean_r is the "ocean" ramp, reversed.
         "range": [0.0, 1.0]
     }
 

docs/style_howto_components.rst

@@ -119,16 +119,22 @@ bands to make the blue channel:
     all_bands_cfg = {
         "components": {
             "red": {
+                # Weighting factors should sum to (close to) 1.0
+                # 0.333 + 0.333 + 0.333 = 0.999 ~ 1.0
                 "red": 0.333,
                 "green": 0.333,
                 "blue": 0.333,
             },
             "green": {
-             "nir": 1.0
+                # Weighting factors should sum to (close to) 1.0
+                # So use 1.0 for a single band.
+                "nir": 1.0
             },
             "blue": {
-             "swir1": 0.5,
-             "swir2": 0.5,
+                # Weighting factors should sum to (close to) 1.0
+                # 0.5 + 0.5 = 1.0
+                "swir1": 0.5,
+                "swir2": 0.5,
             },
         },
         "scale_range": (50, 3000),