add resources, add link to demo in README

Author: ehinman

README.md

@@ -6,13 +6,12 @@
 
 ## Latest Announcements
 
-:mega: **12/04/2025:** `dataretrieval` now features the new `waterdata` module,
+:mega: **01/16/2025:** `dataretrieval` now features the `waterdata` module,
 which provides access to USGS's modernized [Water Data
 APIs](https://api.waterdata.usgs.gov/). The Water Data API endpoints include
 daily values, **instantaneous values**, field measurements, time series metadata,
-and discrete water quality data from the Samples database. This new module will
-eventually replace the `nwis` module, which provides access to the legacy [NWIS
-Water Services](https://waterservices.usgs.gov/).
+and discrete water quality data from the [Samples database](https://waterdata.usgs.gov/download-samples/#dataProfile=site). This new module replaces the `nwis` module, which provides access to the legacy [NWIS
+Water Services](https://waterservices.usgs.gov/). Take a look at the new [`waterdata` module demo notebook](demos/WaterData_demo.ipynb), which walks through an extended example using a majority of the available `waterdata` functions.
 
 Check out the [NEWS](NEWS.md) file for all updates and announcements.
 

demos/WaterData_demo.ipynb

@@ -527,7 +527,7 @@
    "metadata": {},
    "source": [
     "### Field values\n",
-    "Finally, let's see if there are any discharge field measurements for these sites. These are manually recorded measurements (by a human), often used during calibration checks. We will use `waterdata.get_field_measurements()` to check. More commonly, a user would head to this function to gather groundwater level information."
+    "Finally, let's see if there are any discharge field measurements for these sites. These are manually recorded measurements (by a human), often used during calibration checks. We will use `waterdata.get_field_measurements()` to check. More commonly, a user would head to this function to gather groundwater level data, which are categorized as field measurements."
    ]
   },
   {
@@ -587,7 +587,15 @@
    "metadata": {},
    "source": [
     "## Additional Resources\n",
-    "Check out the links below for more information on the Water Data APIs and other ways to download USGS water data:\n"
+    "The USGS Water Data APIs belong to the Water Data for the Nation (WDFN) group of applications and tools. These products exist under the broader National Water Information System (NWIS) program. Check out the links below for more information on the USGS Water Data APIs and other ways to download or view USGS water data:\n",
+    "* [Water Data APIs Home](https://api.waterdata.usgs.gov/)\n",
+    "* [Get an API Key](https://api.waterdata.usgs.gov/signup/)\n",
+    "* [Water Data API OGC Endpoint Catalog](https://api.waterdata.usgs.gov/ogcapi/v0/collections?f=html)\n",
+    "* [Water Data Download Form](https://api.waterdata.usgs.gov/download)\n",
+    "* [Water Data for the Nation Home](https://waterdata.usgs.gov/)\n",
+    "* [Water Data for the Nation Feedback Form](https://waterdata.usgs.gov/questions-comments/?referrerUrl=https://api.waterdata.usgs.gov)\n",
+    "* [R dataRetrieval package](https://github.com/DOI-USGS/dataretrieval)\n",
+    "* [WDFN Blog Post on NWISWeb Decommissioning Timeline](https://waterdata.usgs.gov/blog/nwisweb-decommission-campaign2/)\n"
    ]
   }
  ],