Skip to content

Flesh out fuel duty documentation page (#747)#1697

Open
vahid-ahmadi wants to merge 1 commit into
mainfrom
vahid-ahmadi/issue-747-fuel-duty-docs
Open

Flesh out fuel duty documentation page (#747)#1697
vahid-ahmadi wants to merge 1 commit into
mainfrom
vahid-ahmadi/issue-747-fuel-duty-docs

Conversation

@vahid-ahmadi
Copy link
Copy Markdown
Collaborator

Summary

  • Closes Documentation page for fuel duty #747.
  • docs/book/programs/gov/hmrc/fuel-duty.ipynb existed as a stub: a one-paragraph intro plus a historical-rate chart. The stub left out how PolicyEngine actually computes household-level fuel duty, never mentioned Rural Fuel Duty Relief, and pointed at no legislation.
  • Updates the page to cover:
    • the per-household formula (petrol_and_diesel_rate - rural_relief * in_relief_area) * (petrol_litres + diesel_litres), with pointers to the variable and parameter files,
    • a section on Rural Fuel Duty Relief and the in_rural_fuel_duty_relief_area input flag added in Rural Fuel Duty Relief Scheme #676,
    • statutory/HMRC references (Hydrocarbon Oil Duties Act 1979, Notice 2001, SI 2011/2935).
  • Also fixes the chart title typo "giesel" -> "diesel".

Test plan

  • Notebook still valid JSON, opens in Jupyter; saved outputs unchanged.
  • Docs build job renders the new sections cleanly.

🤖 Generated with Claude Code

The existing fuel-duty.ipynb stub only covered the headline rate history.
Expand it with:

- the household-level fuel_duty formula (litres x effective rate),
- a section on Rural Fuel Duty Relief and the in_rural_fuel_duty_relief_area
  flag added in #676,
- legislative references (Hydrocarbon Oil Duties Act 1979, Notice 2001,
  SI 2011/2935).

Also fix the chart title typo ("giesel" -> "diesel").
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 fuel duty

1 participant