Application: specialist-publisher

Publishes specialist documents on GOV.UK

• GitHub: specialist-publisher
• Ownership: #govuk-publishing-experience-tech
• Hosting: AWS (EKS)
• Category: Publishing apps
• Links:
  • specialist-publisher.publishing.service.gov.uk
  • Sentry (error tracking)
  • Deployment dashboard
  • Argo CD (specialist-publisher)

Relevant manual pages

• Uptime Metrics

Example pages published by specialist-publisher

• Finance and support for your business
• Countryside Stewardship grant finder
• Employment tribunal decisions
• Pholcodine-containing cough and cold medicines: withdrawal from UK market as a precautionary measure
• Class 2 Medicines Recall: Various Marketing Authorisation Holders, pholcodine-containing products, EL (23)A/09
• Alerts, recalls and safety information: drugs and medical devices
• Competition and Markets Authority cases
• Find an export health certificate
• Notifiable animal disease cases and control zones
• Class 4 Medicines Defect Information: Macarthys Laboratories t/a Martindale Pharma, Venlafaxine XL 150mg, 225mg, 300mg prolonged-release tablets, EL(23)A/10

README

Publishing App for Specialist Documents.

This application does not store documents in a database of its own. Instead it uses Publishing API to store and retrieve documents. MongoDB is used for storing local user records.

Formats can be flagged as pre-production (only publishable on development and integration). Read Creating and editing specialist document typesfor details.

Some live examples

• AAIB Reports
• CMA Cases
• Countryside Stewardship Grants
• Drug Safety Update
• International Development Funds
• Medical Safety Alerts
• MAIB Reports
• RAIB Reports
• Research For Development Outputs
• UK Market Conformity Assessment Bodies

Nomenclature

• Format: Category of a Document. Format names are listed in the Live Examples section above and include MAIB Reports and CMA Cases.
• Finder: Sometimes Formats are referred to as Finders. They are called ‘Finders’ because each one of them creates a finder on GOV.UK, e.g. https://www.gov.uk/raib-reports. The formats are served by Finder Frontend.
• Document: Specialist Documents are created by Government editors and can be published to GOV.UK. Documents differ depending on their format, largely determined by the format’s schema.
• Schema: JSON files defining attributes for each format, including base_path, document_noun and document_type. It also contains the facets and their possible values for each document_type which are displayed by _form.html.erb.

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

You may find that you can’t see any documents after replicating data. To fix this, you need to grant user permissions in this application:

bundle exec rake permissions:grant['Joanne Bloggs'] # Or whichever user you're logged in as.

Running the test suite

$ bundle exec rake

Further documentation

• Email alerts
• Rake tasks
• Creating and editing specialist document types
• Updating existing organisation data
• Historical info about migrating to use the Publishing API

Licence

MIT License