Merge pull request #31 from CU-ESIIL/codex/add-context-to-innovation-summit-links

Add context for Innovation Summit datasets

Author: ttuff

docs/innovation-summit-2025.md

@@ -4,26 +4,27 @@
 
 ![Innovation Summit 2025](assets/pre-summit-training-header.png)
 
-- [Air data](hazards/Air_data/Air_data.md)
-- [FAO](food/FAOSTAT/FAO.md)
-- [FIRED](hazards/FIRED/FIRED.md)
-- [NLCD](maka-sitomniya/NLCD/NLCD.md)
-- [Phenology network](forecasting/Phenology_network/Phenology_network.md)
-- [epa water quality](water/epa_water_quality/epa_water_quality.md)
-- [epica dome c ch4](hazards/epica_dome_c_ch4/epica_dome_c_ch4.md)
-- [global forest change](maka-sitomniya/global_forest_change/global_forest_change.md)
-- [iNaturalist](scale/iNaturalist/iNaturalist.md)
-- [lidar canopy height](remote_sensing/lidar_canopy_height/lidar_canopy_height.md)
-- [neon and lter](harmonization/neon_and_lter/neon_and_lter.md)
-- [neon aquatic](water/neon_aquatic/neon_aquatic.md)
-- [neon hyperspectral](remote_sensing/neon_hyperspectral/neon_hyperspectral.md)
-- [neon lidar and organismal](harmonization/neon_lidar_and_organismal/neon_lidar_and_organismal.md)
-- [nrcs soil exploration](maka-sitomniya/NRCS/nrcs_soil_exploration.md)
-- [osm](solutions/osm/osm.md)
-- [prism](forecasting/prism/prism.md)
-- [rap-tiles](vegetation/rap-tiles/rap-tiles.md)
-- [sentinel streaming](remote_sensing/sentinel_streaming/sentinel_streaming.md)
-- [usgs water services](water/usgs_water_services/usgs_water_services.md)
-- [watershed boundaries](maka-sitomniya/watershed_boundaries/watershed_boundaries.md)
-- [weatherbench](AI/weatherbench/weatherbench.md)
+- [Air data](hazards/Air_data/Air_data.md) - EPA county-level air quality metrics track pollution-driven tipping points.
+- [FAO](food/FAOSTAT/FAO.md) - Global food balance sheets reveal agricultural trends linked to ecological transitions.
+- [FIRED](hazards/FIRED/FIRED.md) - Wildfire event polygons highlight landscapes nearing fire-driven tipping points.
+- [NLCD](maka-sitomniya/NLCD/NLCD.md) - National land cover maps expose land-use changes that can trigger ecosystem shifts.
+- [Phenology network](forecasting/Phenology_network/Phenology_network.md) - Seasonal plant and animal observations signal climate-driven ecological transitions.
+- [epa water quality](water/epa_water_quality/epa_water_quality.md) - Water-quality monitoring helps detect aquatic systems approaching degradation thresholds.
+- [epica dome c ch4](hazards/epica_dome_c_ch4/epica_dome_c_ch4.md) - Antarctic methane records provide context for modern atmospheric tipping points.
+- [global forest change](maka-sitomniya/global_forest_change/global_forest_change.md) - Landsat-based forest loss and gain reveal deforestation tipping points worldwide.
+- [iNaturalist](scale/iNaturalist/iNaturalist.md) - Citizen-science species occurrences capture biodiversity shifts near critical thresholds.
+- [lidar canopy height](remote_sensing/lidar_canopy_height/lidar_canopy_height.md) - NEON lidar canopy models track forest structure changes preceding regime shifts.
+- [nclimgrid](hazards/nclimgrid/nclimgrid.md) - NOAA gridded climate normals show trends that may push regions past climate tipping points.
+- [neon and lter](harmonization/neon_and_lter/neon_and_lter.md) - Integrated macroinvertebrate data uncover aquatic community transitions.
+- [neon aquatic](water/neon_aquatic/neon_aquatic.md) - Sensor-based water data monitor freshwater systems for early warning signs.
+- [neon hyperspectral](remote_sensing/neon_hyperspectral/neon_hyperspectral.md) - High-resolution spectral imagery detects vegetation stress before ecosystem tipping.
+- [neon lidar and organismal](harmonization/neon_lidar_and_organismal/neon_lidar_and_organismal.md) - Fusing structural and biological data links habitat change to ecological thresholds.
+- [nrcs soil exploration](maka-sitomniya/NRCS/nrcs_soil_exploration.md) - Soil survey attributes illuminate land degradation tipping points.
+- [osm](solutions/osm/osm.md) - OpenStreetMap vectors map human pressures that drive ecological tipping dynamics.
+- [prism](forecasting/prism/prism.md) - Gridded temperature and precipitation normals track climate trends toward tipping points.
+- [rap-tiles](vegetation/rap-tiles/rap-tiles.md) - Rangeland Analysis Platform tiles reveal vegetation transitions and desertification risk.
+- [sentinel streaming](remote_sensing/sentinel_streaming/sentinel_streaming.md) - Sentinel-2 quicklooks enable rapid detection of landscape changes near thresholds.
+- [usgs water services](water/usgs_water_services/usgs_water_services.md) - Streamflow and groundwater APIs flag hydrologic systems near critical limits.
+- [watershed boundaries](maka-sitomniya/watershed_boundaries/watershed_boundaries.md) - Hydrologic unit maps frame catchments vulnerable to ecological shifts.
+- [weatherbench](AI/weatherbench/weatherbench.md) - Benchmark datasets support models predicting extreme events and tipping points.
 

docs/tags.md

@@ -84,6 +84,7 @@
 - [ICS209 Plus](hazards/ICS209_plus/ICS209_Plus.md)
 - [Uranium mines](hazards/Uranium_mines/Uranium_mines.md)
 - [epica dome c ch4](hazards/epica_dome_c_ch4/epica_dome_c_ch4.md)
+- [nclimgrid](hazards/nclimgrid/nclimgrid.md)
 
 ## ics209_plus
 
@@ -105,28 +106,29 @@
 
 ![Innovation Summit 2025](assets/pre-summit-training-header.png)
 
-- [Air data](hazards/Air_data/Air_data.md)
-- [FAO](food/FAOSTAT/FAO.md)
-- [FIRED](hazards/FIRED/FIRED.md)
-- [NLCD](maka-sitomniya/NLCD/NLCD.md)
-- [Phenology network](forecasting/Phenology_network/Phenology_network.md)
-- [epa water quality](water/epa_water_quality/epa_water_quality.md)
-- [epica dome c ch4](hazards/epica_dome_c_ch4/epica_dome_c_ch4.md)
-- [global forest change](maka-sitomniya/global_forest_change/global_forest_change.md)
-- [iNaturalist](scale/iNaturalist/iNaturalist.md)
-- [lidar canopy height](remote_sensing/lidar_canopy_height/lidar_canopy_height.md)
-- [neon and lter](harmonization/neon_and_lter/neon_and_lter.md)
-- [neon aquatic](water/neon_aquatic/neon_aquatic.md)
-- [neon hyperspectral](remote_sensing/neon_hyperspectral/neon_hyperspectral.md)
-- [neon lidar and organismal](harmonization/neon_lidar_and_organismal/neon_lidar_and_organismal.md)
-- [nrcs soil exploration](maka-sitomniya/NRCS/nrcs_soil_exploration.md)
-- [osm](solutions/osm/osm.md)
-- [prism](forecasting/prism/prism.md)
-- [rap-tiles](vegetation/rap-tiles/rap-tiles.md)
-- [sentinel streaming](remote_sensing/sentinel_streaming/sentinel_streaming.md)
-- [usgs water services](water/usgs_water_services/usgs_water_services.md)
-- [watershed boundaries](maka-sitomniya/watershed_boundaries/watershed_boundaries.md)
-- [weatherbench](AI/weatherbench/weatherbench.md)
+- [Air data](hazards/Air_data/Air_data.md) - EPA county-level air quality metrics track pollution-driven tipping points.
+- [FAO](food/FAOSTAT/FAO.md) - Global food balance sheets reveal agricultural trends linked to ecological transitions.
+- [FIRED](hazards/FIRED/FIRED.md) - Wildfire event polygons highlight landscapes nearing fire-driven tipping points.
+- [NLCD](maka-sitomniya/NLCD/NLCD.md) - National land cover maps expose land-use changes that can trigger ecosystem shifts.
+- [Phenology network](forecasting/Phenology_network/Phenology_network.md) - Seasonal plant and animal observations signal climate-driven ecological transitions.
+- [epa water quality](water/epa_water_quality/epa_water_quality.md) - Water-quality monitoring helps detect aquatic systems approaching degradation thresholds.
+- [epica dome c ch4](hazards/epica_dome_c_ch4/epica_dome_c_ch4.md) - Antarctic methane records provide context for modern atmospheric tipping points.
+- [global forest change](maka-sitomniya/global_forest_change/global_forest_change.md) - Landsat-based forest loss and gain reveal deforestation tipping points worldwide.
+- [iNaturalist](scale/iNaturalist/iNaturalist.md) - Citizen-science species occurrences capture biodiversity shifts near critical thresholds.
+- [lidar canopy height](remote_sensing/lidar_canopy_height/lidar_canopy_height.md) - NEON lidar canopy models track forest structure changes preceding regime shifts.
+- [nclimgrid](hazards/nclimgrid/nclimgrid.md) - NOAA gridded climate normals show trends that may push regions past climate tipping points.
+- [neon and lter](harmonization/neon_and_lter/neon_and_lter.md) - Integrated macroinvertebrate data uncover aquatic community transitions.
+- [neon aquatic](water/neon_aquatic/neon_aquatic.md) - Sensor-based water data monitor freshwater systems for early warning signs.
+- [neon hyperspectral](remote_sensing/neon_hyperspectral/neon_hyperspectral.md) - High-resolution spectral imagery detects vegetation stress before ecosystem tipping.
+- [neon lidar and organismal](harmonization/neon_lidar_and_organismal/neon_lidar_and_organismal.md) - Fusing structural and biological data links habitat change to ecological thresholds.
+- [nrcs soil exploration](maka-sitomniya/NRCS/nrcs_soil_exploration.md) - Soil survey attributes illuminate land degradation tipping points.
+- [osm](solutions/osm/osm.md) - OpenStreetMap vectors map human pressures that drive ecological tipping dynamics.
+- [prism](forecasting/prism/prism.md) - Gridded temperature and precipitation normals track climate trends toward tipping points.
+- [rap-tiles](vegetation/rap-tiles/rap-tiles.md) - Rangeland Analysis Platform tiles reveal vegetation transitions and desertification risk.
+- [sentinel streaming](remote_sensing/sentinel_streaming/sentinel_streaming.md) - Sentinel-2 quicklooks enable rapid detection of landscape changes near thresholds.
+- [usgs water services](water/usgs_water_services/usgs_water_services.md) - Streamflow and groundwater APIs flag hydrologic systems near critical limits.
+- [watershed boundaries](maka-sitomniya/watershed_boundaries/watershed_boundaries.md) - Hydrologic unit maps frame catchments vulnerable to ecological shifts.
+- [weatherbench](AI/weatherbench/weatherbench.md) - Benchmark datasets support models predicting extreme events and tipping points.
 
 ## justice
 
@@ -170,6 +172,10 @@
 
 - [NCES](education/NCES/NCES.md)
 
+## nclimgrid
+
+- [nclimgrid](hazards/nclimgrid/nclimgrid.md)
+
 ## neon
 
 - [neon](forecasting/neon/neon.md)
@@ -247,8 +253,8 @@
 
 - [lidar canopy height](remote_sensing/lidar_canopy_height/lidar_canopy_height.md)
 - [neon hyperspectral](remote_sensing/neon_hyperspectral/neon_hyperspectral.md)
-- [sentinel2 aws](remote_sensing/sentinel2_aws/sentinel2_aws.md)
 - [sentinel streaming](remote_sensing/sentinel_streaming/sentinel_streaming.md)
+- [sentinel2 aws](remote_sensing/sentinel2_aws/sentinel2_aws.md)
 
 ## scale
 

scripts/build_tags.py

@@ -9,6 +9,56 @@
 topic_dir = docs_dir / 'topic'
 mkdocs_path = Path('mkdocs.yml')
 
+# Descriptions for Innovation Summit datasets
+summit_descriptions = {
+    'Air data':
+        'EPA county-level air quality metrics track pollution-driven tipping points.',
+    'FAO':
+        'Global food balance sheets reveal agricultural trends linked to ecological transitions.',
+    'FIRED':
+        'Wildfire event polygons highlight landscapes nearing fire-driven tipping points.',
+    'NLCD':
+        'National land cover maps expose land-use changes that can trigger ecosystem shifts.',
+    'Phenology network':
+        'Seasonal plant and animal observations signal climate-driven ecological transitions.',
+    'epa water quality':
+        'Water-quality monitoring helps detect aquatic systems approaching degradation thresholds.',
+    'epica dome c ch4':
+        'Antarctic methane records provide context for modern atmospheric tipping points.',
+    'global forest change':
+        'Landsat-based forest loss and gain reveal deforestation tipping points worldwide.',
+    'iNaturalist':
+        'Citizen-science species occurrences capture biodiversity shifts near critical thresholds.',
+    'lidar canopy height':
+        'NEON lidar canopy models track forest structure changes preceding regime shifts.',
+    'nclimgrid':
+        'NOAA gridded climate normals show trends that may push regions past climate tipping points.',
+    'neon and lter':
+        'Integrated macroinvertebrate data uncover aquatic community transitions.',
+    'neon aquatic':
+        'Sensor-based water data monitor freshwater systems for early warning signs.',
+    'neon hyperspectral':
+        'High-resolution spectral imagery detects vegetation stress before ecosystem tipping.',
+    'neon lidar and organismal':
+        'Fusing structural and biological data links habitat change to ecological thresholds.',
+    'nrcs soil exploration':
+        'Soil survey attributes illuminate land degradation tipping points.',
+    'osm':
+        'OpenStreetMap vectors map human pressures that drive ecological tipping dynamics.',
+    'prism':
+        'Gridded temperature and precipitation normals track climate trends toward tipping points.',
+    'rap-tiles':
+        'Rangeland Analysis Platform tiles reveal vegetation transitions and desertification risk.',
+    'sentinel streaming':
+        'Sentinel-2 quicklooks enable rapid detection of landscape changes near thresholds.',
+    'usgs water services':
+        'Streamflow and groundwater APIs flag hydrologic systems near critical limits.',
+    'watershed boundaries':
+        'Hydrologic unit maps frame catchments vulnerable to ecological shifts.',
+    'weatherbench':
+        'Benchmark datasets support models predicting extreme events and tipping points.',
+}
+
 def derive_tags(md_path):
     parts = md_path.relative_to(docs_dir).parts[:-1]
     tags = []
@@ -53,7 +103,11 @@ def read_title(content, md_path):
             f.write('[Visit the Innovation Summit website](https://www.colorado.edu/esiil/)\n\n')
             f.write('![Innovation Summit 2025](assets/pre-summit-training-header.png)\n\n')
         for title, path in sorted(tags_map[tag]):
-            f.write(f'- [{title}]({path})\n')
+            desc = summit_descriptions.get(title)
+            if tag == 'innovation-summit-2025' and desc:
+                f.write(f'- [{title}]({path}) - {desc}\n')
+            else:
+                f.write(f'- [{title}]({path})\n')
         f.write('\n')
 
 tag_counts = {tag: len(paths) for tag, paths in tags_map.items()}
@@ -78,7 +132,11 @@ def read_title(content, md_path):
     f.write('[Visit the Innovation Summit website](https://www.colorado.edu/esiil/)\n\n')
     f.write('![Innovation Summit 2025](assets/pre-summit-training-header.png)\n\n')
     for title, path in sorted(tags_map.get('innovation-summit-2025', [])):
-        f.write(f'- [{title}]({path})\n')
+        desc = summit_descriptions.get(title)
+        if desc:
+            f.write(f'- [{title}]({path}) - {desc}\n')
+        else:
+            f.write(f'- [{title}]({path})\n')
     f.write('\n')
 
 if mkdocs_path.exists():