Application: collections-publisher

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

Ownership

#govuk-platform-health owns the application and is responsible for updating its dependencies.

Hosting

The production version of this application is hosted on AWS.

SSH Access (AWS)

gds govuk connect ssh -e integration backend
gds govuk connect ssh -e staging aws/backend
gds govuk connect ssh -e production aws/backend

Run a rake task

• Run a Rake task on Integration
• Run a Rake task on Staging
• ⚠️ Run a Rake task on Production ⚠️

Links

• GitHub repo
• Sentry (error tracking)
• Puppet configuration
• Deploy scripts
• Deployment dashboard
• Publishing E2E scenarios (warning: not all apps have E2E tests)

Example pages published by collections-publisher

• Coronavirus (COVID-19): guidance and support
• Driving and transport
• Driving licences
• Benefits
• Vehicle tax, MOT and insurance
• Money and tax
• Universal Credit
• Coronavirus (COVID-19): Business support
• Get Tax-Free Childcare: step by step
• Income Tax

README

Warning The content below is pulled in directly from the repository.
Links might not function properly.

The Collections Publisher publishes:

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

These pages are then served by the collections app.

Live examples

• collections-publisher

Nomenclature

See the README of collections frontend.

Technical documentation

This is a Ruby on Rails application for internal use by GDS and some departmental editors.

It has these features:

• Creating & editing topics and mainstream browse pages.
• Creating & editing step by step navigation pages, and where they are used as sidebar and sticky navigation.
• Curate the pages tagged to a topic or browse page into “curated lists”. This means they’ll be displayed in a group with a title. By default, the links are not curated and will appear with a ‘A-Z’ heading.

Left, a curated mainstream browse page, right, an uncurated browse page.

Example of a step by step navigation page.

Example of step by step navigation used as sidebar navigation for one of the primary pages.

This application uses the sidekiq message queue for background work (mainly publishing to the Publishing API).

Dependencies

• alphagov/publishing-api -
  • used for the publishing workflow of mainstream_browse_pages, topics, curated lists and step_by_step_pages.
  • Publishing API sends data onto Rummager for search indexing topic, mainstream_browse_page and step_by_step_page pages.

Running the test suite

The test suite includes testing against
govuk-content-schemas, so
you will need a copy of this repo on your file system. By default this should
be in a sibling directory to your project. Alternatively, you can specify their
location with the GOVUK_CONTENT_SCHEMAS_PATH environment variable.

To run the test suite:

bundle exec rake

Licence

MIT License