Updated documentation for internal consistency.

internal/standards/doc.go

@@ -1,8 +1,14 @@
-// Package standards contains shared canonical vocabularies and lookup tables
-// used across multiple providers.
+// File: internal/standards/doc.go
 //
-// The guiding principle is:
-// - Canonical types live in internal/model (provider-independent).
-// - Shared reference tables and helpers live here.
-// - Provider-specific mapping logic lives in internal/sources/<provider>.
+// Package standards defines weatherfeeder’s provider-agnostic “project law”:
+//
+//   - Schema identifiers and versioning conventions (see schema.go).
+//   - Canonical interpretations / cross-provider mappings that are not specific to a
+//     single upstream API (e.g., shared code tables, text heuristics, unit policy).
+//
+// Standards are used by both sources and normalizers. Keep this package free of
+// provider-specific logic and free of dependencies on internal/sources/* or
+// internal/normalizers/* to avoid import cycles.
+//
+// Provider-specific decoding and mapping lives in internal/normalizers/<provider>.
 package standards