Content Standards
Purpose
These standards define the quality requirements for all content on WaterBalanceTools. They apply to both editorially written content and programmatically generated content.
Accuracy
All numerical values, ranges, and recommendations must be traceable to the canonical data layer (data/datasets/). No page may contain hardcoded scientific values that bypass dataset validation. Accuracy is verified at build time by validate-datasets.js and validate-trust.js.
Clarity
Content is written for pool and spa owners who are not chemists. Technical terminology is defined on first use. Jargon is avoided unless it is the established industry term. Every technical article must link to the relevant glossary entry.
Completeness
Every calculator must document what it calculates, what it does not calculate, and what external factors may affect results. Every dataset must document its source priority, version, and last review date. Every formula must document its variables and assumptions.
Consistency
Units are consistent within each page and consistent with the canonical unit definitions in data/datasets/units.json. Terminology follows the canonical entity names in data/graph/entity-index.json. Contradictions between pages are treated as errors and resolved at build time.
Disclosure of Limitations
Calculator results are clearly identified as estimates. Known limitations of each calculator are disclosed in the trust panel. Environmental factors (temperature, sunlight, bather load) that affect real-world results are documented.
Maintenance
Content standards are enforced at build time. The validate-trust.js script rejects builds that fail to meet minimum standards for trust metadata, version information, and confidence level assignment.
Review Frequency
Content standards are reviewed annually and updated when significant changes to platform architecture or data layer require new requirements.