Application: publisher

Publishes mainstream content on GOV.UK

• GitHub: publisher
• Ownership: #govuk-publishing-mainstream-experience-tech
• Category: Publishing apps
• Links:
  • publisher.publishing.service.gov.uk
  • 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 (publisher)

Example pages published by publisher

• Sign in to your Universal Credit account
• Check the MOT history of a vehicle
• HMRC online services: sign in or set up an account
• Tax your vehicle
• Get information about a company
• Check if a vehicle is taxed
• View your eVisa and get a share code to prove your immigration status online
• Get an electronic travel authorisation (ETA) to visit the UK
• View or share your driving licence information
• Universal Credit

README

Publisher is sometimes referred to as “mainstream publisher”.

Live examples

• Answer
• Completed transaction
• Guide
• Help page
• Local transactions
• Place
• Service sign in
• Simple smart answer
• Transaction

Retired formats

• Campaign
• Programme
• Video
• Licence (Migrated to Specialist Licence Finder)

Removed formats

• Business Support - used to be retired, and the documents remained visible, now they’re fully removed as editions and no longer visible in the app (although the artefacts do still exist). They have been fully migrated to specialist-publisher.

Nomenclature

• Artefact: a document on GOV.UK.

Technical documentation

This is a Rails application 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.

Testing

The default rake task runs all the tests:

bundle exec rake

State machine

Maps out the transitions between states for the Edition class. These transitions are defined in the workflow module. A diagram of the current state machine can be seen here: state machine diagram. The diagram can be (re)generated using the state_machines-graphviz gem, by doing:

bundle exec rake state_machines:draw CLASS=Edition TARGET=docs

This will generate a diagram in the docs/state_machines folder.

Querying the database of a deployed publisher app

Publisher stores its data in DocumentDB, which can’t be queried using the instructions detailed in the GOV.UK developer docs. Instead, follow these instructions for querying the database.

Feature flags

For details on how feature flags are managed in Publisher, see the feature flags documentation.

Adding promotions to Completed Transactions

For instructions on how to add a new type of promotion to Completed Transactions, see the “adding a promotion” documentation.

Further documentation

• Fact Checking

Working with Service Sign In pages

These pages do not have an admin interface and are instead managed through rake tasks.

See the README for more details.

Licence

MIT License