0.0
No commit activity in last 3 years
No release in over 3 years
Gem to distribute the DSS Tech Docs Template. See https://github.com/dof-dss/tech-docs-gem for the project.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 2.0.1
>= 0
~> 2.18.0
~> 3.7.0
~> 3.1.0
~> 10.0
~> 3.7.0

Runtime

 Project Readme

DSS 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 DSS style. This repository will age quickly as there is no attempt to keep this in sync with the published GEM. This repository was created on 25th April 2019.

👉 Find out more about the template and its features from the Tech Docs Template documentation.

Usage

👉 Find out how to generate a new website with the Tech Docs Template.

Contributing

Everybody who uses this project is encouraged to contribute.

👉 See CONTRIBUTING.md for guidance on making changes.

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

If you want to see how your changes to the gem affect your website, you have to point your site's Gemfile to your local checkout:

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

To view your changes locally run:

bundle exec middleman server

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

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.

Tests

The repository contains automated JavaScript tests that use Jasmine test framework.

To run the 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

This is a manual process for now.

Licence

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.