Application: hmrc-manuals-api

API for HMRC to publish manuals to GOV.UK

• GitHub: hmrc-manuals-api
• Ownership: #govuk-content-apis owns the repo. #govuk-content-apis-system-alerts receives automated alerts for this repo.
• Category: APIs
• Links:
  • Sentry (error tracking)
  • App dashboard: request rates, errors, durations
  • Kibana App Logs (Production, last 3 hours)
  • Kibana Worker Logs (Production, last 3 hours)
  • Argo CD (hmrc-manuals-api)

Example pages published by hmrc-manuals-api

• VATGPB9700 - Government departments and health bodies: Contracted Out Services (COS) Headings: contents
• EIM23151 - Car benefit: double cab pickups 6 April 2025 onwards
• Pensions Tax Manual
• Capital Gains Manual
• NIM39110 - National Insurance Numbers (NINOs): Format and Security: What a NINO looks like
• Inheritance Tax Manual
• RFIG20500 - Statutory Residence Test (SRT): The ties test: Contents
• ESM4120 - Particular Occupations: entertainment industry – TV and radio workers - behind the camera workers roles normally treated as self-employed, Appendix 1 table
• RFIG20000 - Statutory Residence Test (SRT): contents
• SDLTM62320 - Processing - what forms to use to notify a land transaction: further guidance for completing forms SDLT1, SDLT3 and SDLT4 - further guidance for question 29 SDLT1, local authority number

README

Provides an API for a system built by HMRC to publish tax manuals onto GOV.UK. In many ways it is analogous to a backend/admin app for publishing on GOV.UK. Content which passes validation and checks for unsanitary content is submitted to the GOV.UK Publishing API application. The application does not have a database itself. An HMRC manual consists of two document types: the manual itself and manual sections.

Nomenclature

• Manual: HMRC manual with title and description, contains many Sections. See Adding or updating a manual for more details.

• Section: Sections can contain sub-sections and/or a content body. See Adding or updating a section for more details.

Technical documentation

This is a Ruby on Rails app, and should follow our Rails app conventions.

You can use the GOV.UK Docker environment to run the application and its tests with all the necessary dependencies. Follow the usage instructions to get started.

Use GOV.UK Docker to run any commands that follow.

Running the test suite

bundle exec rspec

Manuals and decisions

See the extended documentation for details:

• Connecting to the API
• Adding or updating a manual
• Adding or updating a section
• Responses to PUT requests
• Slugs, Section Ids and Urls
• Content Ids
• Markup
• Manual Tags
• Removing published manuals
• Testing publishing in GOV.UK Docker
• Managing manuals and sections with rake
• Responses to PUT requests

Licence

MIT License