Skip to content
Switch branches/tags
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Tech Docs Template - gem

This repo contains the Ruby gem that distributes the Tech Docs Template. The Tech Docs Template is a middleman template that you can use to build technical documentation using a GOV.UK style.

To find out more about setting up and managing content for a website using this template, see the Tech Docs Template documentation.


Everybody who uses this project is encouraged to contribute.

You can find out more about contributing to this project from file.

GOV.UK frontend

This gem uses GOV.UK Frontend, part of the GOV.UK Design System.

We use npm to download the govuk-frontend package. To update to a new version, change the version in the package.json file and run npm update.

Developing locally

There are 2 ways to develop with this gem. You can see your changes on either:

  • your own Tech Docs Template website
  • the example in this repository

Use your own Tech Docs Template website

To see how your changes to the gem affect your website, point your website's Gemfile to your local checkout:

gem 'govuk_tech_docs', path: '../tech-docs-gem'

To preview your documentation changes locally, see the Tech Docs Template documentation on previewing your documentation.

Use the example in this repo

To start the example in this repo, run:

cd example
bundle install
bundle exec middleman server

See your website on http://localhost:4567 in your browser.

For more information on previewing your documentation locally, see the Tech Docs template documentation on previewing your documentation.


This repository contains automated JavaScript tests that use the Jasmine test framework.

You can run these tests and see the results in your browser.

  1. Run bundle exec rake jasmine.
  2. Go to http://localhost:8888 in your browser.

To run the tests and see the results in your terminal, run:

bundle exec rake jasmine:ci

Releasing new versions

To release a new version, create a new pull request (PR) that updates version.rb and

Do not include other changes in your pull request, as this makes it easier to find out what was released when. See an example of a PR for releasing a new version.

Travis will automatically release a new version to


Unless stated otherwise, the codebase is released under the MIT License. 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.