Document future-date policy announcements (#636)#1727
Open
vahid-ahmadi wants to merge 1 commit into
Open
Conversation
#636 (2022) asked for an explicit way to encode announced-but-not-yet- implemented policy changes, citing the Truss "growth plan" tax cuts as the motivating example. The feature has been live the whole time — the date-keyed parameter values mechanism handles it natively — but it wasn't documented. Persist the pattern in-repo at docs/book/policy/future-date-announcements.md covering: - the mechanism (parameter values keyed by effective date, latest on or before the query date wins), - the three common patterns: * announced-then-reversed (Truss mini-budget): two rows, one at announcement date with the announced value, one at reversal date with the actual landing value; * phased-in changes: one row per phase with separate references (NI thresholds through the Health & Social Care Levy + April 2024 cuts as a worked example); * announced abolitions: limit value up to the effective date, then sentinel (.inf or 0) from that date onwards (Budget 2025 two-child limit removal as the cross-link), - best practices: cite every future-dated row, don't extrapolate beyond what was announced, use policy_date queries for back-cast scenarios, - distinction from gov.contrib.* reform parameters (uncertain / hypothetical) vs baseline future-dated rows (announced policy).
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
docs/book/policy/future-date-announcements.mdcovering:policy_datequeries for back-cast scenarios,gov.contrib.*reform parameters (uncertain / hypothetical) vs baseline future-dated rows (announced policy).Test plan
policy/.🤖 Generated with Claude Code