Merge branch 'main' into jt/admin-favicon-fix

.github/actions/setup-site/action.yml

@@ -44,3 +44,7 @@ runs:
           --password=drupal \
           --user=root \
           weathergov
+
+    - name: clear the Drupal cache
+      shell: bash
+      run: make cc

.github/workflows/code-standards.yaml

@@ -210,6 +210,9 @@ jobs:
       - name: run browser tests (Playwright)
         if: needs.should-test.outputs.yes == 'true'
         uses: ./.github/actions/browser-tests-playwright
+      - name: dump drupal logs
+        if: always()
+        run: docker compose logs drupal
 
   merge-reports:
     # Merge reports after playwright-tests, even if some shards have failed

docs/research.md

@@ -0,0 +1,36 @@
+<h1> How has research been involved in informing the weather.gov 2.0 design? </h1>
+
+* Understanding the challenges that both internal and external users experience through open-ended “generative” research 
+* Understanding the ins and outs of the existing systems through onsite visit 
+* Getting quick feedback on in-progress designs and prototypes from folks that will use the website
+* Designing and implementing internal and external surveys to get continuous feedback 
+
+<h2> What research has the team done to date? </h2>
+<p>Last updated: August 2024 </p>
+
+<h3> Generative research </h3>
+
+| Name  | When  | Goals  | Insights  | Deck (Restricted Access) |
+| -------- | ------- | -------- | ------- |------- |
+| Path Analysis | April 2023 | Initial research with stakeholders, partners and forecasters across NWS to understand the problem space | Users experience challenges finding and understanding content due to the organization of the website which is based on the NWS org structure. Significant inconsistencies make data hard to interpret, areas do not map to areas that decision makers use. |[Deck](https://docs.google.com/presentation/d/1u6_msv_ogHgPo_1D8OZCnc_VxRAMMf7L4kmII1ZcSy4/edit?usp=sharing)|
+| WFO onsite - Sterling (DC) | July 2023 | Onsite tour + observations at Sterling WFO office (DC area). Includes in-depth notes on internal tools and systems (AWIPs, etc) | Understanding of current forecaster workflow and tools in creating forecasts and various types of content  |[Deck](https://docs.google.com/presentation/d/1OSFmdQef4q4itPgeQF9PaF2hiShDFwkMnoHXFvpMJVc/edit?usp=sharing)|
+| Forecaster research | Sept 2023 | Validate our understanding of the forecaster experience before, during and after a weather hazard | Began to identify some common needs for a CMS experience |[Deck](https://docs.google.com/presentation/d/12ZfChB199txqyp0PlOWCPQvsjmN1Hjp8NdeJoKg5KIU/edit?usp=sharing)|
+| WFO onsite - Nashville | Nov 2023 | Better understand partner experiences before, during and after a weather hazard | Identified partner painpoints during a hazard - post-event support, mapping and radar, etc |[Deck](https://docs.google.com/presentation/d/17x-QsdJN8q4u1GZ8qJVZm6s0srlBZxFiV9dtstbbYR0/edit?usp=sharing)|
+| R6 - Content Strategy testing | June 2024 | Understand what supplementary information users need beyond forecasts, and how they want to find and use them | Hypothesis of how to organize content, by locations that are relevant to decision maker areas. | [Deck](https://docs.google.com/presentation/d/1ovcYx8XbZXcWj_j13wOKGSLYQEFZllieIj_ShsYFTOI/edit?usp=sharing)|
+
+
+<h3> General public usability research </h3>
+
+| Name  | When  | Interest  | Usability| Relevance| Comprehension| Deck (Restricted Access) |
+| -------- | ------- | -------- | ------- |------- | -------- | -------- |
+| R1 - Usability (public) | Dec 2024 | 🟠The information was generally what users were looking for, although EMs would continue to rely on more advanced tools without enhancements | 🟡 Moderate issues interpretting data | 🟠 Prompts to find what they were looking for |  -------- |[Deck](https://docs.google.com/presentation/d/1tbOs4QxaAPvD-RO9-cv8ZJCvBRMWYN3egQxbWi5tGeg/edit?usp=sharing)|
+| R2 - Usability (public) | Jan 2024 |  🟡 Most participants said they would try out weather.gov alongside other apps and website | 🟡 Some participants had some issues finding what they were looking for | 🟠 Additional details required | 🟠 Issues interpreting metrics | [Deck](https://docs.google.com/presentation/d/1fspeYmrbelbo4Gcq6Wb7lR1hdPAXhiO-K_KJUtoQS1I/edit?usp=sharing)|
+| R3 - Usability (public + partner)| Mar 2024 | 🟡 Most participants said they would try out weather.gov, including those that do not currently use it | 🟠 Screenreader dependent user had moderate challenges, some info surprising | 🟢 General public participants found what they were looking for, EM needs consistent with known gaps| 🟢 Minor issues, most comprehensive issues resolved |[Deck](https://docs.google.com/presentation/d/1I00ZNIfwCAhJZwd8tKivEYWNBqLO9RmnCDS7SA28lvc/edit?usp=sharing)|
+| R5 - Unmoderated testing pilot | May 2024 | 🟡 Range of enthusiasm but engaged general public  | 🟢 No major navigation issues, but minor friction navigating tabs consistent with other observed behavior |🟡 Desires for additional data points and functionality consistent with roadmap and known gaps |🟢 No major issues |[Deck](https://docs.google.com/presentation/d/1qif1XlCzrx9Qw9HnUYmRIMdRtUGH4u_ORX4_MfGRB44/edit?usp=sharing)|
+
+<h3> Internal research </h3>
+
+| Name  | When  | Interest  | Usability| Relevance| Comprehension|Deck (Restricted Access) |
+| -------- | ------- | -------- | ------- |------- | -------- |-------- |
+| R4- Usability (CMS, forecasters) | Apr 2024 | All forecasters required assistance to find the right content | Most forecasters stated that it was easy to use (avg 2/5 rating with 1 being easiest). Most of the difficulty comes with uncertainty on content and confusion in publishing/saving.  | Parallel initiatives make it confusing to communicate the changed intent for content. | Supports general workflow but does not support recent innovations in workflows |[Deck](https://docs.google.com/presentation/d/1G2KZHqiptDbXN6OOjkdq0bhI9OyqtTUWTMHzqVYTtjI/edit?usp=sharing)|
+

tests/api/data/testing/products/07330a8f-cd88-4337-902e-24f91ad7371c.json

@@ -0,0 +1,14 @@
+{
+    "@context": {
+        "@version": "1.1",
+        "@vocab": "https://api.weather.gov/ontology#"
+    },
+    "@id": "https://api.weather.gov/products/07330a8f-cd88-4337-902e-24f91ad7371c",
+    "id": "07330a8f-cd88-4337-902e-24f91ad7371c",
+    "wmoCollectiveId": "FXUS61",
+    "issuingOffice": "KOKX",
+    "issuanceTime": "2024-08-20T17:48:00+00:00",
+    "productCode": "AFD",
+    "productName": "Area Forecast Discussion",
+    "productText": "\n000\nFXUS61 KOKX 201748\nAFDOKX\n\nArea Forecast Discussion\nNational Weather Service New York NY\n148 PM EDT Tue Aug 20 2024\n\n.SYNOPSIS...\nLow pressure pulls away to the northeast today. High pressure \ngradually builds across through mid week. High pressure will \nremain the predominate feature Thursday through much of the \nweekend. High pressure may lose hold as weak low pressure passes\nto our north late Sunday into early next week.\n\n&&\n\n.NEAR TERM /THROUGH TONIGHT/...\nMain change this update was to decrease cloud cover today. This\nseems prudent with a strong inversion at 800 mb, dry low-levels,\nand subsident NW flow off of Catskills. Stratocu development to\nthe NW of the Lower Hudson Valley quite extensive on latest \nsatellite imagery, but struggling to get into the area, except \nfor SE CT.\n\nOtherwise, the upper low drops into northern NY state later \ntoday. The lower and middle levels by and large will continue to\ndry out with a noticeably drier NW flow regime setting up \nacross the area. The most noticeable change is the lowering of \ndew points across the region from west to east throughout today \nand into tonight. Dew points fall into the much more comfortable\n40s and 50s today. Highs are forecast to get into the upper 60s\nand lower 70s, with spots in an around the NYC metro a bit \nwarmer. This is about 5 to 10 degrees below average. The lower \nlevels should be dry enough for today into tonight to preclude \nany rain shower activity despite some spokes of upper level \nenergy from the upper level low swinging through.\n\n&&\n\n.SHORT TERM /WEDNESDAY THROUGH WEDNESDAY NIGHT/...\nThe upper and mid level trough axis will swing through during \nWednesday. Despite this, predominantly dry weather continues \nfor the mid week. There is only a slight chance of a few widely\nscattered showers for mainly northern locations Wed afternoon.\nOtherwise, mainly just some low level fair weather clouds can \nbe expected from time to time with the lower and mid levels \nbeing relatively dry and synoptic scale sinking motion \nincreasing overall as high pressure will continue to gradually \nbuild from the west. Dew point readings will remain in the \ncomfortable 50s providing seasonably cool weather for this time \nof year. Day time temperatures will be close to 10 degrees below\naverage Wednesday with mainly lower and middle 70s for day time\nmaxes, and temperatures Wednesday night running below average \nwith night time mins in the lower 50s across the interior and \nupper 50s closer to the coast.\n\n&&\n\n.LONG TERM /THURSDAY THROUGH MONDAY/...\nNo significant changes in the long term and stuck fairly close to \nprevious forecast/NBM. \n\nSurface high pressure builds into the region from the Great Lakes on \nThursday and remains in place through much of the weekend. This will \nlead to an extended period of dry weather. A trough exits to the \neast late Thursday and early Friday as a ridge takes over. This will \nlead to gradually warming temperatures. NW flow continues on \nThursday under high pressure keep high temperatures in the upper to \nlow 70s. Upper 70s to lower 80s return on Friday as ridging builds \naloft and surface winds become more westerly, eventually \nsouthwesterly by the afternoon. Westerly to southerly flow continues \ninto the weekend allowing for further warming with highs in the \nlow/mid-80s. \n\nGlobal models are not in a consensus late Sunday into Monday. The \nGFS has a trough develop over the area while the ECMWF have the \ntrough farther displaced from our area, mainly to the northeast then \neast. Only the GFS solution would bring a chance for rain. Given the \ndivergence in model guidance, have kept POPs out of of the ending \nperiods in the extended forecast.\n\n&&\n\n.AVIATION /18Z TUESDAY THROUGH SUNDAY/...\nHigh pressure slowly builds into the region through tonight.\n\nVFR.\n\nWind speeds around 10-15kt with occasional gusts around 20 kt \nthrough this afternoon. The gusts will likely end in the evening\nwith winds remaining out of the NW around 10kt or less tonight,\nthen between 10-15 kt on Wednesday.\n\n ...NY Metro (KEWR/KLGA/KJFK/KTEB) TAF Uncertainty...\n\nGusts may be occasional this afternoon. \n\nOUTLOOK FOR 18Z WEDNESDAY THROUGH SUNDAY...\n\nWednesday-Sunday: VFR.\n\nDetailed information, including hourly TAF wind component forecasts, \ncan be found at: https:/www.weather.gov/zny/n90\n\n&&\n\n.MARINE...\nBased on latest obs and guidance, all SCAs on the ocean have\nbeen discontinued. \n\nA NW flow prevails in the wake of a cold front. A pressure \ngradient exists with the cold front offshore and building high \npressure to the west. Mainly sub small craft conditions today\nwith gusts to around 20 kt. Otherwise, sub small craft \nconditions prevail through the upcoming weekend as high \npressure builds into the coastal waters.\n\n&&\n\n.HYDROLOGY...\nNo hydrological impacts are expected through the entire forecast \nperiod.\n\n&&\n\n.TIDES/COASTAL FLOODING...\nA high rip current risk is in place through 8 pm this evening \ndue to elevated, long period swells from Ernesto.\n\nWith a full moon earlier this week and higher astronomical \ntides lingering expect minor coastal flood benchmarks to be \napproached or slightly exceeded for tonight's high tide cycle \nacross SW CT and the south shore bays of Nassau and Queens. This\nis being handled with coastal flood statements. Elsewhere minor\nbenchmarks are not expected to be approached.\n\n&&\n\n.OKX WATCHES/WARNINGS/ADVISORIES...\nCT...None.\nNY...High Risk for Rip Currents until 8 PM EDT this evening for NYZ075-\n     080-081-178-179.\nNJ...None.\nMARINE...None.\n\n&&\n\n$$\n\nSYNOPSIS...BC/JE/DW\nNEAR TERM...JE/DW\nSHORT TERM...JE\nLONG TERM...BC\nAVIATION...20\nMARINE...BC/JE/DW\nHYDROLOGY...BC/JE\nTIDES/COASTAL FLOODING...\n"
+}

tests/api/data/testing/products/08ca0238-ea1b-4d1a-9cb7-f03c3ccafd0d.json

@@ -0,0 +1,14 @@
+{
+    "@context": {
+        "@version": "1.1",
+        "@vocab": "https://api.weather.gov/ontology#"
+    },
+    "@id": "https://api.weather.gov/products/08ca0238-ea1b-4d1a-9cb7-f03c3ccafd0d",
+    "id": "08ca0238-ea1b-4d1a-9cb7-f03c3ccafd0d",
+    "wmoCollectiveId": "FXUS61",
+    "issuingOffice": "KOKX",
+    "issuanceTime": "2024-08-20T11:25:00+00:00",
+    "productCode": "AFD",
+    "productName": "Area Forecast Discussion",
+    "productText": "\n000\nFXUS61 KOKX 201125\nAFDOKX\n\nArea Forecast Discussion\nNational Weather Service New York NY\n725 AM EDT Tue Aug 20 2024\n\n.SYNOPSIS...\nLow pressure pulls away to the northeast today and into Nova Scotia \ntonight. High pressure gradually builds across through mid week.\nHigh pressure will remain the predominate feature Thursday \nthrough much of the weekend. High pressure may lose hold as weak\nlow pressure passes to our north late Sunday into early next \nweek.\n\n&&\n\n.NEAR TERM /THROUGH TONIGHT/...\nOnly adjustment for this update was to include chance of a few\nlight showers early this morning across far east and northeast\nportions of the area. It should push out quickly in the next \nfew hours, otherwise no changes.\n\nAn upper level low slides across the Eastern Great Lakes and \npivots into Upstate New York. The lower and middle levels by and\nlarge will continue to dry out with a noticeably drier NW flow \nregime setting up across the area. The most noticeable change is\nthe lowering of dew points across the region from west to east \nthroughout today and into tonight. Dew points fall into the much\nmore comfortable 50s today, with some dew points getting into \nthe upper 40s across northern and northwestern areas tonight. \nWith the cooler air mass in place and scattered to broken clouds\nindicated by BUFKIT profiles and steep low level lapse rates, \nexpect temperatures to reach the mainly the middle 70s today, \nwith a few pockets of lower 70s in spots resulting in \ntemperatures a good 5 to 10 degrees below average. The lower \nlevels should be dry enough for today into tonight to preclude \nany rain shower activity despite some spokes of upper level \nenergy from the upper level low swinging through.\n\n&&\n\n.SHORT TERM /WEDNESDAY THROUGH WEDNESDAY NIGHT/...\nThe upper and mid level trough axis will swing through during \nWednesday. Despite this, predominantly dry weather continues \nfor the mid week. There is only a slight chance of a few widely\nscattered showers for mainly northern locations Wed afternoon.\nOtherwise, mainly just some low level fair weather clouds can \nbe expected from time to time with the lower and mid levels \nbeing relatively dry and synoptic scale sinking motion \nincreasing overall as high pressure will continue to gradually \nbuild from the west. Dew point readings will remain in the \ncomfortable 50s providing seasonably cool weather for this time \nof year. Day time temperatures will be close to 10 degrees below\naverage Wednesday with mainly lower and middle 70s for day time\nmaxes, and temperatures Wednesday night running below average \nwith night time mins in the lower 50s across the interior and \nupper 50s closer to the coast.\n\n&&\n\n.LONG TERM /THURSDAY THROUGH MONDAY/...\nNo significant changes in the long term and stuck fairly close to \nprevious forecast/NBM. \n\nSurface high pressure builds into the region from the Great Lakes on \nThursday and remains in place through much of the weekend. This will \nlead to an extended period of dry weather. A trough exits to the \neast late Thursday and early Friday as a ridge takes over. This will \nlead to gradually warming temperatures. NW flow continues on \nThursday under high pressure keep high temperatures in the upper to \nlow 70s. Upper 70s to lower 80s return on Friday as ridging builds \naloft and surface winds become more westerly, eventually \nsouthwesterly by the afternoon. Westerly to southerly flow continues \ninto the weekend allowing for further warming with highs in the \nlow/mid-80s. \n\nGlobal models are not in a consensus late Sunday into Monday. The \nGFS has a trough develop over the area while the ECMWF have the \ntrough farther displaced from our area, mainly to the northeast then \neast. Only the GFS solution would bring a chance for rain. Given the \ndivergence in model guidance, have kept POPs out of of the ending \nperiods in the extended forecast.\n\n&&\n\n.AVIATION /12Z TUESDAY THROUGH SATURDAY/...\nHigh pressure slowly builds into the region today and tonight.\n\nMainly VFR. There is a chance for an isolated light shower or\nsprinkle early this morning across eastern portions of Long \nIsland and Connecticut. There may also be brief periods of MVFR\nceilings around 2.5-3kft. \n\nWinds will remain NW through the TAF period. Wind speeds around\n10 kt increase to 10-15kt with gusts around 20 kt. The gusts \ncould end up occasional and any gusts likely end in the evening.\nWinds become 10kt or less once again tonight. \n\n ...NY Metro (KEWR/KLGA/KJFK/KTEB) TAF Uncertainty...\n\nGusts may be occasional today. \n\nOUTLOOK FOR 12Z WEDNESDAY THROUGH SATURDAY...\n\nWednesday-Saturday: VFR.\n\nDetailed information, including hourly TAF wind component forecasts, \ncan be found at: https:/www.weather.gov/zny/n90\n\n&&\n\n.MARINE...\nA NW flow prevails in the wake of a cold front. A pressure gradient \nexists with the cold front offshore and building high pressure to \nthe west. Mainly sub small craft conditions, with marginal small \ncraft conditions at times through today for the ocean with gusts to \naround 20 kt which also includes the near shore coastal waters.\nThus have left up a small craft advisory through 16z for the\nwestern and central ocean zones, and until 18z for the eastern\nmost ocean. Otherwise sub small craft conditions prevail for \nTuesday night and through the upcoming weekend as high pressure\nbuilds into the coastal waters.\n\n&&\n\n.HYDROLOGY...\nNo hydrological impacts are expected through the entire forecast \nperiod.\n\n&&\n\n.TIDES/COASTAL FLOODING...\nA high rip current risk is in place through 8 pm this evening \ndue to elevated, long period swells from Ernesto.\n\nWith a full moon earlier this week and higher astronomical \ntides lingering expect minor coastal flood benchmarks to be \napproached or slightly exceeded for tonight's high tide cycle \nacross SW CT and the south shore bays of Nassau and Queens. This\nis being handled with coastal flood statements. Elsewhere minor\nbenchmarks are not expected to be approached.\n\n&&\n\n.OKX WATCHES/WARNINGS/ADVISORIES...\nCT...None.\nNY...High Risk for Rip Currents through this evening for NYZ075-080-081-\n     178-179.\nNJ...None.\nMARINE...Small Craft Advisory until 2 PM EDT this afternoon for ANZ350.\n     Small Craft Advisory until noon EDT today for ANZ353-355.\n\n&&\n\n$$\n\nSYNOPSIS...BC/JE\nNEAR TERM...JE\nSHORT TERM...JE\nLONG TERM...BC\nAVIATION...BC\nMARINE...BC/JE\nHYDROLOGY...BC/JE\nTIDES/COASTAL FLOODING...\n"
+}