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
2nd line
How to...
- Incorrect postcode data
- Raise issues with Reliability Engineering
- Retrieve shared credentials from AWS Secrets Manager
- SmartSurvey scheduled maintenance
- Update popular links
Learn
- Access to Licensify for Third Parties
- Communicate when Slack is unavailable
- Licensify - supporting licensing
- On-call support
- Rules for getting production access
- Subject Access Request (SAR)
- Technical 2nd line
- Zendesk
A/B testing
How to...
Learn
Accounts
How to...
Applications
How to...
- Application ownership
- Create a Local Transaction
- Name a new application or gem
- Retire a repo
- Retire an application
- Set up a new Rails application
Learn
- Architectural deep-dive of GOV.UK
- Architectural summary of GOV.UK
- Architecture overview of GOV.UK applications
- Configure linting
- Conventions for Rails applications
Assets
How to...
Learn
AWS
How to...
Learn
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
- 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
- Find a rails template based on a GOV.UK URL or vice verca
- 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
Incidents
How to...
Learn
Infrastructure
How to...
- Add a new Ruby version
- Databases on GOV.UK
- Manage Amazon MQ
- Manage OpenSearch on AWS
- Manually resize EBSs (elastic block store)
- Move apps between servers
- Provision machines for data science research
- Reprovision a machine
Learn
- Domain Name System (DNS) records
- GOV.UK and Virtual Private Networks (VPNs)
- GOV.UK's environments (integration, staging, production)
- 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
Logging
How to...
Learn
Monitoring and alerting
How to...
- Debug underperforming search
- GOV.UK Chat Alerts
- How we handle errors
- Pingdom
- Router error ratio too high
- Signon API user token expires soon
- Travel Advice or Drug and Medical Device email alerts not sent
Learn
- Graphite and deployment dashboards
- PagerDuty
- Pingdom Bouncer canary check
- Screens that we have in the office
- Sentry
- Sidekiq
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 translation in Whitehall
- 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...
- Change an organisation's slug
- Check for a 'gone' route
- Edit an existing route in the Router
- Redirect a route
Security
How to...
- Content Security Policy on GOV.UK
- Pentests
- Set up a YubiKey
- Web Application Firewall (WAF) configuration