Manual
Common tasks
How to...
- Create a Local Transaction
- Deploy an emergency banner
- Deploy non-emergency global banner
- Post a message on the status page
- Purge a page from cache
- Query Kibana (includes useful queries)
- Run a rake task
Learn
A/B testing
How to...
Learn
Accounts
How to...
Applications
How to...
- Application ownership
- Configure linting
- Create a Local Transaction
- Incorrect postcode data
- Name a new application or gem
- Retire a repo
- Retire an application
- Set up a new Rails application
- Update popular links
Learn
- Architectural deep-dive of GOV.UK
- Architectural summary of GOV.UK
- Architecture overview of GOV.UK applications
- Conventions for Rails applications
Assets
How to...
Learn
Authentication and authorisation
Learn
AWS
How to...
- Google Cloud Platform (GCP)
- How to check and commit code to AWS CodeCommit
- How to raise a support ticket with AWS
Backups
How to...
- Backup and restore databases in AWS RDS
- Fix out-of-date search indices
- Restore Elasticsearch indices from backup
Learn
CDN & Caching
How to...
Learn
Content Data
Learn
Cookies
Learn
data.gov.uk
How to...
Learn
Databases
How to...
Dependencies
How to...
Learn
Deployment
How to...
- Deploy Static
- Deploy when GitHub is unavailable
- Deployments
- Fall back to AWS CloudFront
- GOV.UK content mirrors
- Publish special routes
- Run a rake task
- Set up Heroku review apps for pull requests
Learn
Docker
Learn
Documentation
How to...
Learn
Emails
How to...
Learn
- Document Collection emails - a special case
- Email notifications: how they work
- Email signup journeys and email subscriptions across GOV.UK
- How we use GOV.UK Notify
Emergency Alerts
How to...
Learn
Frontend
How to...
- Deploy a banner to certain pages
- Find a rails template based on a GOV.UK URL or vice verca
- How to remove jQuery from JavaScript
- How to test with Assistiv Labs
- Migrate to Dart Sass from LibSass
- Track frontend performance with SpeedCurve
Learn
- Analytics on GOV.UK
- Frontend architecture
- GA4 Implementation Record
- Google Tag Manager change process
- Guidance and tools for digital accessibility
- Local frontend development
- The component system
- Which browsers we support
GitHub
How to...
Learn
GOV.UK Account
Learn
Incident management
Learn
Incident response
Learn
Incidents
How to...
Infrastructure
How to...
- Add a new Ruby version
- Databases on GOV.UK
- Manage Amazon MQ
- Manage OpenSearch on AWS
- Provision machines for data science research
- Raise issues with Reliability Engineering
- Retrieve shared credentials from AWS Secrets Manager
Learn
- Domain Name System (DNS) records
- GOV.UK's environments (integration, staging, production)
- Organisations API
- Rate Limiting
- Terraform Cloud
Learning GOV.UK
How to...
Learn
- Dictionary of concepts on GOV.UK
- How to be a good buddy
- Responsibilities of a Tech Lead
- Where to find what documentation
- Zendesk
Licensing
Learn
Logging
How to...
Learn
Monitoring and alerting
How to...
- Debug underperforming search
- GOV.UK Chat Alerts
- How we handle errors
- Pingdom
- Rotate Fastly automation token for Prometheus exporter
- Router error ratio too high
- Signon API user token expires soon
- Travel Advice or Drug and Medical Device email alerts not sent
- Whitehall error ratio too high
Learn
Packaging
How to...
Publishing
How to...
- Add a new document type
- Add an organisation's brand colour or logo
- Add Historical Accounts
- Add support for a new language on GOV.UK
- Change a slug and create redirect in Whitehall
- Change a specialist document base path
- Content that doesn't show up correctly in search or list pages
- Debug published documents with incorrect links
- Deploy an emergency banner
- Deploy non-emergency global banner
- Find usage of Govspeak in content
- Help with publishing content
- If documents aren't live after being published
- Make a new document type available to search
- Modify a change note in Publishing API, Content Publisher or Whitehall
- Redirect an HTML attachment's URL in Whitehall
- Reindex an Elasticsearch index
- Remove a change note
- Rename a country
- Republish content
- Support government changes
- Upload HMRC PAYE files
Learn
- Finder schema guidance
- How the draft stack works
- How the topic taxonomy works
- How the world taxonomy works
- Related links
- What data we expose as schema.org structured data
Routing
How to...
Search on GOV.UK
How to...
- Add a best bet to site search
- Boost or demote a document in site search
- How to clear the Redis cache
- How to get or delete a document from Vertex
- How to resync content in Vertex
- Prevent a page being returned in search results
- Prevent an unhelpful autocomplete suggestion
- Search synchronisation errors
- What to do if someone says search is down
Learn
Security
How to...
- Content Security Policy on GOV.UK
- Pentests
- Set up a YubiKey
- Web Application Firewall (WAF) configuration
Team tools
How to...
Testing
How to...
Learn
Transition
How to...
- Configure transition mappings for a site
- Remove a site from the Transition tool
- Request Fastly TLS certificate
- Transition a site to GOV.UK