Update contributor style docs to include continuous legends

nsidc · Aug 8, 2023 · 4bc2dde · 4bc2dde
1 parent 454835d
commit 4bc2dde
Show file tree

Hide file tree

Showing 3 changed files with 22 additions and 1 deletion.
diff --git a/doc/_images/qgis_symbology_legend_settings.png b/doc/_images/qgis_symbology_legend_settings.png
diff --git a/doc/_images/qgis_symbology_linear_interpolation.png b/doc/_images/qgis_symbology_linear_interpolation.png
diff --git a/doc/contributor/how-to/contribute-styles.md b/doc/contributor/how-to/contribute-styles.md
@@ -5,7 +5,7 @@ following process:
 
 * Download (or build) and open the most recent version of the project in QGIS.
 * In the 'Layers' menu, double click on the layer you wish to edit.
-* Open the 'symbology' tab.
+* Open the 'Symbology' tab.
 * Make your desired style changes.
 * In the lower-left corner, click the 'Style' dropdown.
 * In this menu, select 'Save Style...'
@@ -25,6 +25,27 @@ following process:
   `foo.qml`, then populate `style='foo'`.
 
 
+## Continuous colormap considerations
+
+Continuous colormaps, since QGIS 3.18, support displaying a gradient legend.
+
+A colormap is continuous if its interpolation mode is set to "Linear" (in the QML, the
+value is `"INTERPOLATE"`).
+
+!["Linear" interpolation selected in the QGIS symbology
+menu](/_images/qgis_symbology_linear_interpolation.png)
+
+These continuous legends won't display the units we populated in the "Label unit suffix"
+field for QGreenland v2, so some extra effort has to be taken to display them in the new
+continuous legend. In the "Legend Settings" menu, ensure:
+
+* Any units are populated in the "Suffix" field
+* "Orientation" is set to "Horizontal"
+
+![QGIS "Legend Settings" menu with "Suffix" set to "m/s" and "Orientation" set to
+"Horizontal"](/_images/qgis_symbology_legend_settings.png)
+
+
 ## Troubleshooting
 
 ### Layers using my style are displaying font warnings in QGIS on some operating systems