Technical Architecture at the Ministry of Justice

Want to give feedback on the documentation? Open an issue on this repository.

This repository holds the website and documentation for the Technical Architecture website.

This repository uses the Ministry of Justice's template-documentation-site.

Running locally

You can run this website locally by running:

make preview

You can then browse to https://localhost:4567 to view the website.

Updating documentation

You can update the documentation by editing any of the *.html.md.erb files in the source directory.

The syntax used in *.html.md.erb is Markdown, though it also supports some GOV.UK Design System specifics, as listed on Tech Docs Template - Write your content.

Publishing changes

Any changes that are merged into the main branch will be published automatically through the publish.yml GitHub action.

This website is hosted on GitHub Pages.

Configuring the website

Global configuration

The GOV.UK Tech Docs Template global configuration options can be used in this repository to configure this website.

Structuring documentation and page configuration

The GOV.UK Tech Docs Template "Configure your documentation project" offers a range of guidance regarding configuration options to help structure documentation and configure pages separately.