To edit the site you have several options. To make direct edits you must be added as a trusted editor to the repository by an owner however you can propose edits straight away for an editor to merge in.

You can either use the GitHub website or using a text editor on your computer. Either way you’ll need a free GitHub account, you can sign up here.

Ensure you have a verified email address with GitHub otherwise your changes will not trigger a build.

Editing Online


To use the GitHub website use the Improve This Page button on the right hand edge of a page to launch the editor.

If you’re not a trusted editor you’ll be prompted to create a fork and will be led through the process of creating a pull request. Later an editor will check your changes are valid and merge them into the repo.

Editing Locally

This method requires a certain amount of technical knowledge.

This is the more complicated option, the benefits are you can use a desktop text editor and run the entire site on your machine to preview changes before they go live. You should have knowledge of Git and the command line to do this.

See README.md for up to date install instructions.

Getting the site running on your machine locally is easy to do on Mac and Linux. It can be done on Windows, but it’s tricky. The website Run Jekyll on Windows has a full tutorial on how to do this.

Syntaxes Used

A combination of HTML and Markdown (Kramdown variant) is used for marking up our pages. YAML is used for meta data and is documented for shows, committees etc here.

The Kramdown syntax guide is useful for reference.