Skip to main content Link Search Menu Expand Document (external link)

Building Documentation

Make sure you have Nix installed. You may also want to configure the Spectrum binary cache, to avoid having to wait for dependencies to compile on your local system.

  1. Get a copy of the Spectrum source code:

    git clone
  2. Enter the documentation directory:

    cd spectrum/Documentation
  3. Enter the development environment:

  4. In the development shell, do an initial build of the documentation site:

  5. Run a development server for previewing changes locally:

    jekyll serve

    This will serve a local copy of the documentation at http://localhost:4000/.

    Jekyll does not handle rendering of the diagrams. If you modify any of those, or add new ones, run scripts/ again to do a full rebuild of the site.

After making changes to the documentation, see how to send your patch and submit the changes for review.