model/doc.go

// FILE: model/doc.go
// Package model defines weatherfeeder's canonical domain payload types.
//
// These structs are emitted as the Payload of canonical events (schemas "weather.*.vN").
// JSON tags are treated as part of the wire contract for configured sinks.
//
// Compatibility guidance:
//   - Prefer additive changes.
//   - Avoid renaming/removing fields without a schema version bump.
package model
Remove incorrect 'internal/' prefix from model package file header comments 2026-03-17 09:46:39 -05:00			`// FILE: model/doc.go`
model: add explicit JSON tags and document canonical payload contract Add lowerCamelCase JSON tags to canonical model types (observation, forecast, alert) to stabilize the emitted wire format and make payload structure explicit for downstream sinks. Introduce internal/model/doc.go to document these structs as versioned, schema-governed payloads and clarify compatibility expectations (additive changes preferred; breaking changes require schema bumps). No functional behavior changes; this formalizes the canonical output contract ahead of additional sinks and consumers. 2026-01-15 22:39:37 -06:00			`// Package model defines weatherfeeder's canonical domain payload types.`
			`//`
			`// These structs are emitted as the Payload of canonical events (schemas "weather.*.vN").`
Document development workflow and internals 2026-06-10 20:22:38 +00:00			`// JSON tags are treated as part of the wire contract for configured sinks.`
model: add explicit JSON tags and document canonical payload contract Add lowerCamelCase JSON tags to canonical model types (observation, forecast, alert) to stabilize the emitted wire format and make payload structure explicit for downstream sinks. Introduce internal/model/doc.go to document these structs as versioned, schema-governed payloads and clarify compatibility expectations (additive changes preferred; breaking changes require schema bumps). No functional behavior changes; this formalizes the canonical output contract ahead of additional sinks and consumers. 2026-01-15 22:39:37 -06:00			`//`
			`// Compatibility guidance:`
			`// - Prefer additive changes.`
			`// - Avoid renaming/removing fields without a schema version bump.`
			`package model`