You’re welcome to use the template even if your service isn’t considered part of GOV.UK, but your site or service must not:
- identify itself as being part of GOV.UK
- use the crown or GOV.UK logotype in the header
- use the GDS Transport typeface
- suggest that it’s an official UK government website if it’s not
Before you start
Follow the Get started guide for Tech docs
To make changes to the documentation for the Tech Docs Template website, edit files in the
source folder of this repository.
You can add content by editing the
.html.md.erb files. These files support content in:
Preview your changes locally
To preview your new website locally, navigate to your project folder and run:
Or you can run it on Docker:
http://localhost:4567 in your browser. Any content changes you make to your website will be updated in real time.
To shut down the Middleman instance running on your machine, use
If you make changes to the
config/tech-docs.yml configuration file, you need to restart Middleman to see the changes.
To build the HTML pages from content in your
source folder, run:
bundle exec middleman build`
Every time you run this command, the
build folder gets generated from scratch. This means any changes to the
build folder that are not part of the build command will get overwritten.
bundle update to make sure you're using the most recent Ruby gem versions.
bundle exec middleman build --verbose to get detailed error messages to help with finding the problem.
CI / CD
You can find the pipeline here. It self updates when you merge any changes.
See here to set up variables.
How to contribute
- Fork the project (or clone for internal contributors)
- Create a feature or fix branch
- Make your changes (with tests if applicable)
- Raise a pull request
Unless stated otherwise, the codebase is released under the MIT License. This covers both the codebase and any sample code in the documentation.