Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

This repo contains the contents of

Pull requests are welcome! 🎉 Please read our guide on Contributing.

If you want to build the site yourself, to test your changes before opening a pull request, then please check out the Getting Started section below.

Getting Started

These instructions cover running this project locally on both Windows and macOS so that you can preview changes:

  1. Clone* this repository:

    git clone
  2. Download, install, and launch Visual Studio Code and open the root folder of the repository.

  3. (macOS only) In Visual Studio Code, press Command+Shift+P, followed by enter to bring up the Command Palette, then type Tasks and select Tasks: Run Task, followed by hugo SetMaxFilesLimits (run once only) and press enter. Restart your computer. (This step only has to be run once if you have never used hugo before on this computer.)

  4. In Visual Studio Code's left-hand sidebar, navigate to the (file) Explorer section, open the content/en/guides/general/how-this-site-works/ file.

  5. In Visual Studio Code's left-hand sidebar, navigate to Run and Debug > Hugo: Serve ...

    VSCode hugo serve

Your web browser should open to the How This Site Works guide, ready for editing. Changes made to the file in Visual Studio Code should appear in your browser immediately.

* If you are not comfortable using git on the command-line, then check out the git cheat sheet or try GitHub Desktop.

What next?

Once you have cloned or forked this repository and are able to build it locally, please check out the following guides: