docs: refine maps and stations guidance

Author: andrepimpao

README.md

@@ -19,8 +19,8 @@ use yet.
 - [One Call 4.0](docs/one-call.md)
 - [Air Pollution](docs/air-pollution.md)
 - [Weather](docs/weather.md)
-- [Weather Maps](docs/maps.md)
-- [Weather Stations](docs/stations.md)
+- [Maps](docs/maps.md)
+- [Stations](docs/stations.md)
 - [Geocoding](docs/geocoding.md)
 
 ## License

docs/maps.md

@@ -1,4 +1,4 @@
-# Weather Maps
+# Maps
 
 Weather Maps API 1.0 provides current cloud, precipitation, sea-level pressure,
 wind-speed, and temperature overlays. It is available on OpenWeather's standard

docs/stations.md

@@ -1,4 +1,4 @@
-# Weather Stations
+# Stations
 
 The Weather Stations API lets you register and manage personal weather stations
 associated with your OpenWeather account.
@@ -161,6 +161,11 @@ standard METAR codes. See the
 [NOAA METAR reference](https://aviationweather.gov/help/data/#metar) for their
 meanings.
 
+> **Upstream inconsistency:** OpenWeather documents `visibilityPrefix` as a
+> compass-direction string, but its live API rejected a documented string value
+> during verification. Omit this value unless OpenWeather clarifies or corrects
+> the accepted type.
+
 Each `CloudLayer` represents one entry in OpenWeather's `clouds` array. Its
 distance, METAR cloud condition, and cumulus type are optional, but at least one
 value must be provided.
@@ -170,6 +175,11 @@ available METAR precipitation, descriptor, intensity, proximity, obscuration,
 and other codes. At least one value must be provided, and codes are kept as
 strings so additional values accepted by OpenWeather are not restricted.
 
+METAR visibility, cloud, and weather values appear to be write-only in this API.
+A successful submission has no response body, and OpenWeather does not document
+a method for retrieving the original measurement payload. These values
+therefore could not be read back or verified after submission.
+
 ## Retrieve Measurements
 
 Use `measurements()` to retrieve measurements aggregated by minute, hour, or

tests/Fixtures/stations/delete.meta.json

@@ -13,5 +13,5 @@
         "query": {}
     },
     "sanitization": [],
-    "notes": "The generated identifier belongs to the deleted temporary fixture station and is unchanged. The successful response had no body or Content-Type header, and a following list request confirmed the account returned from zero stations to zero."
+    "notes": "The generated identifier belongs to the deleted temporary fixture station and is unchanged. The successful response had no body or Content-Type header, and a following list request confirmed the account returned from one station to zero."
 }

tests/Fixtures/stations/measurements/aggregate-day-success.meta.json

@@ -18,5 +18,5 @@
         }
     },
     "sanitization": [],
-    "notes": "The first aggregate appeared between 23 hours 43 minutes and 31 hours 43 minutes after its three source measurements were accepted. The second aggregate appeared approximately 30 hours after its fully populated source measurement was accepted. Its decimal pressure and rain and snow totals are preserved exactly; submitted METAR structures are absent from the aggregate response."
+    "notes": "The first aggregate appeared between 23 hours 43 minutes and 31 hours 43 minutes after its three source measurements were accepted. The second aggregate appeared approximately 30 hours after its fully populated source measurement was accepted. Its decimal pressure and rain and snow totals are preserved exactly; submitted METAR structures are absent from the aggregate response. The retained station was deleted after capture, and a following list request confirmed that no stations remained."
 }

tests/Fixtures/stations/measurements/aggregate-hour-success.meta.json

@@ -18,5 +18,5 @@
         }
     },
     "sanitization": [],
-    "notes": "The first aggregate appeared between 23 hours 43 minutes and 31 hours 43 minutes after its three source measurements were accepted. The second aggregate appeared approximately 30 hours after its fully populated source measurement was accepted. Its decimal pressure and rain and snow totals are preserved exactly; submitted METAR structures are absent from the aggregate response."
+    "notes": "The first aggregate appeared between 23 hours 43 minutes and 31 hours 43 minutes after its three source measurements were accepted. The second aggregate appeared approximately 30 hours after its fully populated source measurement was accepted. Its decimal pressure and rain and snow totals are preserved exactly; submitted METAR structures are absent from the aggregate response. The retained station was deleted after capture, and a following list request confirmed that no stations remained."
 }

tests/Fixtures/stations/measurements/aggregate-minute-success.meta.json

@@ -18,5 +18,5 @@
         }
     },
     "sanitization": [],
-    "notes": "The first aggregate appeared between 23 hours 43 minutes and 31 hours 43 minutes after its three source measurements were accepted. The second aggregate appeared approximately 30 hours after its fully populated source measurement was accepted. Both empty precipitation objects are preserved exactly."
+    "notes": "The first aggregate appeared between 23 hours 43 minutes and 31 hours 43 minutes after its three source measurements were accepted. The second aggregate appeared approximately 30 hours after its fully populated source measurement was accepted. Both empty precipitation objects are preserved exactly. The retained station was deleted after capture, and a following list request confirmed that no stations remained."
 }

tests/Fixtures/stations/register.meta.json

@@ -24,5 +24,5 @@
             "action": "replaced private account identifier with user-fixture"
         }
     ],
-    "notes": "The deliberately public fixture metadata and generated station identifier are unchanged. The temporary station was deleted and the account returned from zero stations to zero."
+    "notes": "The deliberately public fixture metadata and generated station identifier are unchanged. The temporary station was deleted and the account returned from one station to zero."
 }