Document development workflow and internals

internal/normalizers/nws/alerts.go

@@ -37,7 +37,7 @@ func (AlertsNormalizer) Match(e event.Event) bool {
 }
 
 func (AlertsNormalizer) Normalize(ctx context.Context, in event.Event) (*event.Event, error) {
-	_ = ctx // normalization is pure/CPU; keep ctx for future expensive steps
+	_ = ctx // normalization is pure/CPU; keep signature aligned with Normalizer.
 
 	// If we can't derive AsOf from the payload, fall back to the existing event envelope.
 	fallbackAsOf := in.EmittedAt.UTC()

internal/normalizers/nws/forecast.go

@@ -42,7 +42,7 @@ func (ForecastNormalizer) Match(e event.Event) bool {
 }
 
 func (ForecastNormalizer) Normalize(ctx context.Context, in event.Event) (*event.Event, error) {
-	_ = ctx // normalization is pure/CPU; keep ctx for future expensive steps
+	_ = ctx // normalization is pure/CPU; keep signature aligned with Normalizer.
 
 	return normalizeForecastEventBySchema(in)
 }

internal/normalizers/nws/observation.go

@@ -32,7 +32,7 @@ func (ObservationNormalizer) Match(e event.Event) bool {
 }
 
 func (ObservationNormalizer) Normalize(ctx context.Context, in event.Event) (*event.Event, error) {
-	_ = ctx // normalization is pure/CPU; keep ctx for future expensive steps
+	_ = ctx // normalization is pure/CPU; keep signature aligned with Normalizer.
 
 	return normcommon.NormalizeJSON(
 		in,