Skip to content

DFE-Digital/apply-service-standard-in-dfe

Folders and files

NameName
Last commit message
Last commit date
Dec 8, 2022
Apr 21, 2023
Sep 8, 2022
Apr 21, 2023
May 25, 2022
Jun 8, 2022
May 25, 2022
Dec 19, 2022
Jun 15, 2022
Jun 15, 2022
Jun 8, 2022
Jul 11, 2022
Aug 25, 2022
Nov 16, 2022

Repository files navigation

Apply the Service Standard in the Department for Education

πŸ‘‰ You can find out more about setting up and managing content for this service on the Tech Docs Template documentation site.

Before you start

To run this service on your machine, you need:

Contributing

Make sure you read the Contributing guidance before making any changes.

Making changes

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:

  • Markdown
  • HTML
  • Ruby

πŸ‘‰ You can use Markdown and HTML to generate different content types and Ruby partials to manage content.

πŸ‘‰ Learn more about producing more complex page structures.

Preview your changes locally

To preview your new website locally, navigate to your project folder and run:

bundle exec middleman server

πŸ‘‰ See the generated website on 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 ctrl+C.

If you make changes to the config/tech-docs.yml configuration file, you need to restart Middleman to see the changes.

Build

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.

Troubleshooting

Run bundle update to make sure you're using the most recent Ruby gem versions.

Run bundle exec middleman build --verbose to get detailed error messages to help with finding the problem.

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.