Application: content-publisher

Publishing application for GOV.UK

• GitHub: content-publisher
• Ownership: #govuk-publishing-experience-tech
• Hosting: AWS, on the backend machine class
• Category: Publishing apps
• Rake tasks: Run a Rake task on Integration, Staging or ⚠️ Production ⚠️
• Links:
  • content-publisher.publishing.service.gov.uk
  • Sentry (error tracking)
  • Puppet configuration
  • Deploy scripts
  • Deployment dashboard

Imported documents

• Approach to Analytics
• Editing a document’s change history
• History mode
• Importing documents from Whitehall to Content Publisher
• Removing or removing and redirecting a document
• Scheduled publishing
• Testing Strategy
• User Permissions
• /adr
• 1. Record architecture decisions
• 10. Sending email notifiations
• 11. Moving business logic out of controllers
• 12. Rendering File Attachments outside of Govspeak
• 13. Permitted Deletion
• 14. Political and Government Tagging
• 15. Bulk data loading
• 16. Publishing times and change history
• 2: Use local datastore for publisher workflow
• 3. Initial Domain Modelling
• 4. Editing Microcopy
• 5. Avoiding initialisation flickering in HTML
• 6. Tagging Content to Governments
• 7. Minimal Model
• 8. Restricted Deletion
• 9. Modelling history

Example pages published by content-publisher

• Over eight million households to get new cost-of-living payment from 14 July
• Over 8 million families in the UK getting new cost of living payment from 14 July 2022
• New guidance sets out how to live safely with COVID-19
• Poliovirus detected in sewage from North and East London
• Monkeypox cases confirmed in England – latest updates
• Monkeypox: vaccine to be offered more widely to help control outbreak
• Heat-health alert issued by the UK Health Security Agency
• COVID-19 variants identified in the UK – latest updates
• State Pension and benefit rates for 2022 to 2023 confirmed
• Bill of Rights to strengthen freedom of speech and curb bogus human rights claims

README

A unified publishing application for content on GOV.UK

Nomenclature

• Content - Some text (and related fields) a user wants to publish
• Revision - A version of a piece of content in a particular locale
• Edition - A revision that is in the Publishing API
• Document - All revisions of a piece of content in a particular locale

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.

Before running the app

The first time you run this application for development, enable debug and pre_release_features permissions:

bundle exec rake development_permissions

To enable them for your GOV.UK account add them to your account in Signon.

Running the test suite

bundle exec rake

To run JavaScript tests (only):

# run JS tests in browser
yarn run jasmine:browser

# run JS tests on command line
yarn run jasmine:ci

Our test environment is setup to render ‘real’ error pages, instead of raising an exception. This can make it hard to debug a test failure, as the actual error won’t appear in the test output. Instead, you can see it in log/test.log.

Further documentation

• Approach to analytics
• Editing change note history
• History mode
• Importing documents from Whitehall
• Removing documents
• Scheduled publishing
• Testing strategy
• User permissions

Licence

MIT License