gVisor Website

This repository holds the content for the gVisor website. It uses hugo to generate the website and Docsy as the theme.

Using Github

The easiest way to contribute to the documentation is to use the "Edit this page" link on any documentation page to edit the page content directly via GitHub and submit a pull request. This should generally be done for changes to a single page.

Using Git

You can submit pull requests by making changes in a Git branch. See more information on GitHub pull requests here.

Documentation is located in the content/docs/ directory. Documentation is written in markdown with hugo extensions. Please read more about content management in the hugo documentation.

Requirements

Building the website requires Docker. Please install it before building.

Building

If you want to simply build the website, you can do that using make. This will output the App Engine application code, configuration, and html and CSS into the public/ directory.

make

Testing

You can use the hugo web server for testing documentation or style changes. This will start a webserver that will rebuild the site when you make content changes:

make devserver

Access the site at http://localhost:8080

If you need to test all functionality including redirects you can start the App Engine app locally. However, you will need to restart the app when making content changes:

make server