This Next.js based documentation contains the source code of the website deployed to GitHub Pages.
You will need:
- node v14
It is recommended to use a node package manager like nvm to manage node versions.
First, install the requirements:
npm iThen, run the development server:
npm run devOpen http://localhost:3000 with your browser to see the result.
Upon merging into main, the project is automatically deployed to Github Pages via a Githook Action found in .github/workflows/gh-pages-deploy.yml.
- Page content is stored in MDX format and can be found in
documentation/. - Images are stored in
public/images/ - Site navigation is defined in
lib/menus.js.
To update content, simply update the corresponding .mdx file.
To add a new page:
- Create a new
.mdxfile indocumentation/where the filename will be the URL - Update
lib/menus.jswith a link to the new page, following existing examples - Test locally
- Raise a new PR to
main
Unless stated otherwise, the codebase is released under the MIT Licence. This covers both the codebase and any sample code in the documentation.
The documentation is © Crown copyright and available under the terms of the Open Government 3.0 licence.