changes to level and purpose

esibinga · esibinga · commit ad4dee28baa6 · 2023-10-27T14:55:09.000-04:00
diff --git a/galleries/examples/tag_glossary.rst b/galleries/examples/tag_glossary.rst
@@ -34,6 +34,9 @@ Tag Glossary
 +-----------------------------------+---------------------------------------------+
 |``styling: small-multiples``       |                                             |
 +-----------------------------------+---------------------------------------------+
+|``styling: conditional``           |styling is determined programmatically by a  |
+|                                   |condition being met                          |
++-----------------------------------+---------------------------------------------+
 |                                   |                                             |
 +-----------------------------------+---------------------------------------------+
 |**Primary or relevant plot component**                                           |
@@ -66,18 +69,28 @@ Tag Glossary
 +-----------------------------------+---------------------------------------------+
 |``component: error``               |                                             |
 +-----------------------------------+---------------------------------------------+
+|``component: animation``           |                                             |
++-----------------------------------+---------------------------------------------+
 |                                   |                                             |
 +-----------------------------------+---------------------------------------------+
 |**Interactivity**                                                                |
 +-----------------------------------+---------------------------------------------+
 |``interactivity: event handling``  |                                             |
 +-----------------------------------+---------------------------------------------+
+|``interactivity: click``           |                                             |
++-----------------------------------+---------------------------------------------+
+|``interactivity: mouseover``       |                                             |
++-----------------------------------+---------------------------------------------+
 |``interactivity: zoom``            |                                             |
 +-----------------------------------+---------------------------------------------+
 |``interactivity: pan``             |                                             |
 +-----------------------------------+---------------------------------------------+
 |``interactivity: brush``           |                                             |
 +-----------------------------------+---------------------------------------------+
+|``interactivity: drag``            |                                             |
++-----------------------------------+---------------------------------------------+
+|``interactivity: scroll``          |                                             |
++-----------------------------------+---------------------------------------------+
 |                                   |                                             |
 +-----------------------------------+---------------------------------------------+
 |**Plot Type**                                                                    |
@@ -96,35 +109,41 @@ Tag Glossary
 +-----------------------------------+---------------------------------------------+
 |``plot type: specialty``           |                                             |
 +-----------------------------------+---------------------------------------------+
-|``plot type:          ``           |                                             |
+|``plot type: scatter``             |                                             |
 +-----------------------------------+---------------------------------------------+
 
 
 *2. Structural tags: what format is the example? What context can we provide?*
 
-+-----------------------+-------------------------------------------------------------------+
-|``tag``                | use case                                                          |
-+=======================+===================================================================+
-|``level: reference``   |reference docs like "marker reference" or "list of named colors"   |
-|                       | - dense collection of short-format information                    |
-|                       | - well-defined scope, accessible information                      |
-+-----------------------+-------------------------------------------------------------------+
-|``level``              |level refers to how much context/background the user will need     |
-+-----------------------+-------------------------------------------------------------------+
-|``level: beginner``    |concepts are standalone, self-contained, require only one module   |
-+-----------------------+-------------------------------------------------------------------+
-|``level: intermediate``|concepts may require knowledge of other modules, have dependencies |
-+-----------------------+-------------------------------------------------------------------+
-|``level: advanced``    |concepts require multiple modules and have dependencies            |
-+-----------------------+-------------------------------------------------------------------+
++----------------------------+-------------------------------------------------------------------+
+|``tag``                     | use case                                                          |
++============================+===================================================================+
+|``level``                   |level refers to how much context/background the user will need     |
++----------------------------+-------------------------------------------------------------------+
+|``level: beginner``         |concepts are standalone, self-contained, require only one module   |
++----------------------------+-------------------------------------------------------------------+
+|``level: intermediate``     |concepts may require knowledge of other modules, have dependencies |
++----------------------------+-------------------------------------------------------------------+
+|``level: advanced``         |concepts require multiple modules and have dependencies            |
++----------------------------+-------------------------------------------------------------------+
+|``purpose``                 |what's it here for?                                                |
++----------------------------+-------------------------------------------------------------------+
+|``purpose: storytelling``   |storytelling exemplar -- build a visual argument                   |
++----------------------------+-------------------------------------------------------------------+
+|``purpose: reference``      |reference docs like "marker reference" or "list of named colors"   |
+|                            | - dense collection of short-format information                    |
+|                            | - well-defined scope, accessible information                      |
++----------------------------+-------------------------------------------------------------------+
+|``purpose: fun``            |just for fun!                                                      |
++----------------------------+-------------------------------------------------------------------+
 
 *3. Domain tags: what discipline(s) might seek this example consistently?*
 
 Note: it's futile to draw fences around "who owns what", and that's not the point of domain tags. Domain tags help groups of people to privately organize relevant information, and so are not displayed publicly. See below for a list of existing domain tags. If you don't see the one you're looking for and you think it should exist, consider proposing it.
 
 +-------------------------------+----------------------------------------+
 |``tag``                        | use case                               |
-+=======================+================================================+
++===============================+========================================+
 |``domain``                     |for whom is the example relevant?       |
 +-------------------------------+----------------------------------------+
 |``domain: cartography``        |                                        |
@@ -142,14 +161,19 @@ Note: it's futile to draw fences around "who owns what", and that's not the poin
 
 *4. Internal tags: what information is helpful for maintainers or contributors?*
 
-+---------------------------+-----------------------------------------------------------------------+
-|``tag``                    | use case                                                              |
-+===========================+=======================================================================+
-|``internal: low bandwidth``|allows users to filter out bandwidth-intensive examples like animations|
-+---------------------------+-----------------------------------------------------------------------+
-|``internal: untagged``     |allows docs contributors to easily find untagged examples              |
-+---------------------------+-----------------------------------------------------------------------+
-|``internal: deprecated``   |examples containing deprecated functionality or concepts               |
-+---------------------------+-----------------------------------------------------------------------+
-|``internal: needs-review`` |example needs to be reviewed for accuracy or pedagogical value         |
-+---------------------------+-----------------------------------------------------------------------+
++-------------------------------+-----------------------------------------------------------------------+
+|``tag``                        | use case                                                              |
++===============================+=======================================================================+
+|``internal: low bandwidth``    |allows users to filter out bandwidth-intensive examples like animations|
++-------------------------------+-----------------------------------------------------------------------+
+|``internal: untagged``         |allows docs contributors to easily find untagged examples              |
++-------------------------------+-----------------------------------------------------------------------+
+|``internal: deprecated``       |examples containing deprecated functionality or concepts               |
++-------------------------------+-----------------------------------------------------------------------+
+|``internal: needs-review``     |example needs to be reviewed for accuracy or pedagogical value         |
++-------------------------------+-----------------------------------------------------------------------+
+|``internal: outstanding-todo`` |example has an unfinished to-do                                        |
++-------------------------------+-----------------------------------------------------------------------+
+|``internal: too-much``         |the example should be refined, split into multiple examples, or        |
+|                               |reformatted into a tutorial or reference                               |
++-------------------------------+-----------------------------------------------------------------------+
