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.
Find out how to contribute.
npm to download the govuk-frontend package. To update to a new version, change the version in the package.json file and run
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
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.
To start the example in this repo, run:
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.
You can run these tests and see the results in your browser.
bundle exec rake jasmine.
- Go to
http://localhost:8888in your browser.
To run the tests and see the results in your terminal, run:
bundle exec rake jasmine:ci
Users on OSX Mojave (10.14) may get this error when running
bundle exec middleman serve on apps that use this gem.
There are 3 possible ways to solve this. From best to worst, you can:
- upgrade to macOS 10.15 (Catalina) or higher
- tell rubygems not to use the system ffi by running
gem install ffi -- --disable-system-libffiin the command line when the error shows
- pin the ffi version back to 1.12.2 by editing the Gemfile of your app
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 Rubygems.org.
Unless stated otherwise, the codebase is released under the MIT License. This covers both the codebase and any sample code in the documentation.