Build and serve the docs locally

Prerequisites

Clone the repository:

  1. $ git clone https://github.com/operator-framework/operator-sdk/

The docs are built with Hugo which can be installed along with the required extensions by following the docsy install guide.

Note: Be sure to install hugo-extended.

We use git submodules to install the docsy theme. From the operator-sdk directory, update the submodules to install the theme.

  1. $ git submodule update --init --recursive

Build and Serve

You can build and serve your docs to localhost:1313. From the website directory run:

  1. hugo server

Any changes will be included in real time.

Check Links

make test-links will use containers to build html and check the links. Please consider running this locally before creating a PR to save CI resources.

Last modified May 8, 2020: Add link checker travis job (#2988) (8a2d7c19)