Contributing to the Website

The Submariner documentation website is based on Hugo, Grav, Hugo-theme-learn, and is written in Markdown format.

You can always click the Edit this page link at the top right of each page, but if you want to test your changes locally before submitting you can:

  1. Fork the submariner-io/submariner-website on GitHub.

  2. Check out your copy locally:

    git clone ssh://[email protected]/<your-user>/submariner-website.git
    cd submariner-website
    make server
    
  3. An instance of the website is now running locally on your machine and is accessible at http://localhost:1313.

  4. Edit files in src. The browser should automatically reload so you can view your changes.

  5. Eventually commit, push, and pull-request your changes. You can find a good guide about the GitHub workflow here.

  6. Your changes will be verified by CI. Check the job results for details of any errors.