Version v1.6 of the documentation is no longer actively maintained. The site that you are currently viewing is an archived snapshot. For up-to-date documentation, see the latest version.
This document discusses how to visually inspect documentation changes as they would be applied to the live website. All changes to documentation should be inspected locally before being pushed to a PR.
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.
git submodules to install the docsy theme. From the
operator-sdk directory, update the submodules to install the theme.
git submodule update --init --recursive
Build and Serve
You can build and serve your docs to
localhost:1313. From the
Any changes will be included in real time.
make test-docs will validate changelog fragments, build doc HTML in a container, and check its links.
Please consider running this locally before creating a PR to save CI resources.