MOJ technical guidance
This site documents some of the technical decisions that the Ministry of Justice (MOJ) has made for the products we operate.
It complements the Service Manual, which covers service design more broadly.
Principles
Standards
Operating services
- Avoiding code freezes
- Documenting how your service is supported
- Documenting owners of infrastructure
- How to host services
- Supporting services out of hours
- Reserving infrastructure capacity
Building software
General standards
Adding new guidance
Create a new Markdown file that follows this pattern, add a link to it from this page, and make a pull request:
---
title: The Title of Your Page
last_reviewed_on: 2020-08-05
review_in: 3 months
---
# The Title of Your Page
Introduction of a couple of paragraphs to explain why the thing you're
writing about is important. The [title should probably be a verb, not a
noun][good-services-are-verbs] (e.g. “Storing source code”, not “Code
repositories”).
[good-services-are-verbs]: https://designnotes.blog.gov.uk/2015/06/22/good-services-are-verbs-2/
## User needs
Why do we do this thing? Who is it helping?
## Principles
What broad approaches do we follow when we do this thing?
## Tools
What specific bits of software (commercial or open source) do
we use to help us do this thing?
The service manual has some useful information on learning about and writing user needs.
This page was last reviewed on 9 December 2024.
It needs to be reviewed again on 9 March 2025
by the page owner #operations-engineering-alerts
.
This page was set to be reviewed before 9 March 2025
by the page owner #operations-engineering-alerts.
This might mean the content is out of date.