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 i
Then, run the development server:
npm run dev
Open 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
.mdx
file indocumentation/
where the filename will be the URL - Update
lib/menus.js
with 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.