Add initial guidelines for example tags

Cadair · Cadair · commit 13467318dd3e · 2026-04-30T10:24:12.000+01:00
diff --git a/docs/dev_guide/contents/example_gallery.rst b/docs/dev_guide/contents/example_gallery.rst
@@ -47,3 +47,22 @@ Contribution Guidelines
   * If you need to use ``astropy.visualization.{quantity_support, time_support}``, import these functions at the top of the example, and call them directly before the first plot that needs them.
 
 We recommend checking the other examples in the gallery to see how they are structured and what they contain.
+
+Tagging Examples
+================
+
+All our examples in the gallery are tagged with one or more tags describing what topics the example covers.
+A list of tags looks like this::
+
+  # sphinx_gallery_tags = ["Map", "Coordinates", "AIA"]
+
+The tags we add to examples are:
+
+* Instruments or sources of any data used i.e. ``"AIA", "EUVI", "ADAPT"``.
+* Category of SunPy functionality i.e. ``"Map", "Timeseries", "Coordinates", "Reproject"``.
+* Data provider where appropriate i.e. ``"JSOC", "HEK"`` these should be the focus of an example.
+* Science topic, such as ``"Flares", "Active Regions"``.
+* ``"Visualization"`` should be added to examples where the focus of the example is learning visualization techniques.
+
+Tags should be formatted to be human readable, so should be Title Case and make use of symbols such as ``&``.
+Adding a tag which hasn't already been added should be done thoughtfully.
diff --git a/examples/acquiring_data/querying_and_loading_SHARP_data.py b/examples/acquiring_data/querying_and_loading_SHARP_data.py
@@ -5,7 +5,7 @@
 
 In this example we will demonstrate how to acquire `Spaceweather HMI Active Region Patch (SHARP) <http://jsoc.stanford.edu/doc/data/hmi/sharp/sharp.htm>`__ data and load it into a `sunpy.map.Map`.
 """
-# sphinx_gallery_tags = ["Acquiring Data", "JSOC", "Map", "Active Regions", "HMI"]
+# sphinx_gallery_tags = ["Acquiring Data", "JSOC", "Map", "Active Regions", "HMI", "SHARP"]
 
 import os
 
