README.md

KEDA - Docs

Documentation and landing page for the KEDA project at https://keda.sh.

Running the site locally

Install Hugo (the "extended" version with Hugo Pipes support) and Yarn:

Windows

choco install hugo-extended
choco install yarn

Mac

brew install hugo
brew install yarn

Now you can run the docs locally:

yarn

hugo server -D -F

Publishing the site

The KEDA website is published automatically by Netlify. Any time changes to this repo are pushed to master, the site is re-built and re-published in roughly two minutes.

Adding blog posts

To add a new post to the Keda blog:

hugo new blog/my-new-post.md

This creates a boilerplate Markdown file in content/blog/my-new-post.md whose contents you can modify. The following fields are required:

• title
• date (in YYYY-MM-DD format)
• author

Adding scaler documentation

To add documentation for a new KEDA scaler:

hugo new --kind scaler docs/scalers/my-new-scaler.md

This creates a boilerplate Markdown file in content/docs/scalers/my-new-scaler.md whose contents you can modify. Make sure to update the following metadata fields:

• title
• availability
• maintainer
• description

Updating the FAQ

To update the KEDA FAQ page, update the TOML file at [data/faq.toml]. Here's an example question/answer pair:

[[qna]]
q = "How can I add a new question/answer pair?"
a = "You're looking at it! 😀"

Updating the troubleshooting page

To add a new section to the troubleshooting page:

hugo new troubleshooting/my-new-issue.md

To adjust the order in which the troubleshooting tiles appear, use the weight parameter in each page's metadata.