Skip to content

Expand Universal Credit documentation page (#745)#1700

Open
vahid-ahmadi wants to merge 1 commit into
mainfrom
vahid-ahmadi/issue-745-uc-docs
Open

Expand Universal Credit documentation page (#745)#1700
vahid-ahmadi wants to merge 1 commit into
mainfrom
vahid-ahmadi/issue-745-uc-docs

Conversation

@vahid-ahmadi
Copy link
Copy Markdown
Collaborator

Summary

  • Closes Documentation page for Universal Credit #745.
  • The 2022 issue asked for a UC docs page like the existing Child Benefit one. The page already exists but stopped at "here are some element rates over time" — round it out so it explains the full computation.
  • Additions:
    • New "How PolicyEngine computes Universal Credit" section: uc_maximum_amount -> means test (work allowance + taper + asset rules) -> benefit cap reduction, plus a note on how would_claim_uc handles take-up.
    • References section linking the Welfare Reform Act 2012, the operational regs (SI 2013/376), the annual DWP rate uprating publication, and the UC official statistics page used for calibration.
  • Drive-by fixes in the rates chart:
    • Rebuilt the dataframe in one pass instead of pd.concat inside a loop, which was raising a FutureWarning in the rendered output.
    • Amount(£m) y-axis label is wrong — UC elements are £/month, not millions; corrected to Amount (£/month).
    • Removed an empty trailing code cell.

Test plan

  • Notebook still valid JSON, 5 cells (down from 4 + 1 empty).
  • Docs build job renders the new sections cleanly.

🤖 Generated with Claude Code

The existing page covered six legacy benefits, gave the Welfare Reform Act
2012 link, and showed a chart of selected element rates. Round it out with:

- a "How PolicyEngine computes Universal Credit" section explaining the
  uc_maximum_amount -> means test -> benefit cap pipeline and the
  would_claim_uc take-up input,
- a References section pointing at the primary statute (WRA 2012), the
  operational regs (SI 2013/376), the annual DWP rate uprating publication,
  and the UC official statistics page that policyengine-uk-data calibrates
  against,
- fix the rates dataframe so it builds in one pass instead of pd.concat in
  a loop (which raised FutureWarning) and corrects the "Amount(£m)" axis
  label to "Amount (£/month)",
- drop an empty trailing code cell.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Documentation page for Universal Credit

1 participant