Application: collections-publisher

Publishes step by steps, /browse pages, and legacy /topic pages on GOV.UK

• GitHub: collections-publisher
• Ownership: #govuk-platform-health owns the app. #govuk-corona-services-tech is responsible for updating its dependencies.
• Hosting: AWS, on the backend machine class
• Rake tasks: Run a Rake task on Integration, Staging or ⚠️ Production ⚠️
• Links:
  • Sentry (error tracking)
  • Puppet configuration
  • Deploy scripts
  • Deployment dashboard
  • Publishing E2E scenarios (warning: not all apps have E2E tests)

Imported documents

• Changing the slug of a Tag or Topic
• /arch
• Decision record: Defer Merging of Taxonomy Apps
• Discarding drafts of previously published step by step pages
• Storing the status of step-by-steps

Example pages published by collections-publisher

• Coronavirus (COVID-19): guidance and support
• Visas and immigration
• Driving and transport
• Driving licences
• Get Tax-Free Childcare: step by step
• Travel abroad: step by step
• Vehicle tax, MOT and insurance
• Benefits
• Passports, travel and living abroad
• Passports

README

This app is used by GDS and some departmental editors. It can publish:

• /browse pages
• /topic pages
• step by step pages and step by step sidebar navigation
• coronavirus pages

These pages are then served by the collections app. It is also used to curate pages tagged to a topic or browse page into “curated lists”, instead of a single ‘A-Z’ list, as the following screenshots illustrate.

Nomenclature

See the README of collections frontend.

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 rake

Further documentation

See the docs/ directory for guidance and architectural decisions.

Licence

MIT License