Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Ondat Platform Documentation

Documentation Rendering Lint and Link Checking

This repository contains the Ondat Markdown documentation content published here. The documentation is readable directly out of this repository without needing any extra rendering steps.

The main branch is the latest version of the documentation and is automatically pushed to


Feel free to contribute! We love feedback and interaction with the Community ;)

The below how-to assumes a general knowledge of Git and GitHub or similar services. If you are new to Git and GitHub, refer to the introduction here.


  • Fork the repository
  • Clone the forked repository from your GitHub account:

git clone

Cloning into 'documentation'...
remote: Enumerating objects: 860, done.
remote: Counting objects: 100% (860/860), done.
remote: Compressing objects: 100% (628/628), done.
remote: Total 860 (delta 448), reused 603 (delta 215), pack-reused 0
Receiving objects: 100% (860/860), 87.45 MiB | 1.37 MiB/s, done.
Resolving deltas: 100% (448/448), done.
Updating files: 100% (274/274), done.

  • Create a branch like "new-use-case" or "fixing-type-in-rancher-installation":

git checkout -b new-use-case

  • Create the new content using Markdown and include the header defining title and link as shown below
cat docs/usecases/
title: "ArgoCD"
linkTitle: "ArgoCD"

ArgoCD rocks!
  • Commit the content and push it:

git add --all . && git commit -m "adding a new use case about ArgoCD"

[new-use-case f20b38f] adding a new use case about ArgoCD
 1 file changed, 7 insertions(+)
 create mode 100644 docs/usecases/

git push --set-upstream origin new-use-case

Enumerating objects: 8, done.
Counting objects: 100% (8/8), done.
Delta compression using up to 12 threads
Compressing objects: 100% (5/5), done.
Writing objects: 100% (5/5), 446 bytes | 446.00 KiB/s, done.
Total 5 (delta 3), reused 0 (delta 0), pack-reused 0
remote: Resolving deltas: 100% (3/3), completed with 3 local objects.
remote: Create a pull request for 'new-use-case' on GitHub by visiting:
 * [new branch]      new-use-case -> new-use-case
Branch 'new-use-case' set up to track remote branch 'new-use-case' from 'origin'.
  • Create a Pull Request and document your contribution and
  • an Ondat team member will review your PR contribution and merge it

How to render the docs locally

  • Install hugo extended from the hugo release page, for instance the hugo_extended_0.92.1_macOS-ARM64.tar.gz
  • Clone the documentation-backend: git clone
  • Create symbolic links for the content into the backend directory:
rsync -az $PATH_TO_DOCS_SOURCE/docs/ $PATH_TO_DOCS_BACKEND/hugo-backend/content/docs
rsync -az $PATH_TO_DOCS_SOURCE/sh/ $PATH_TO_DOCS_BACKEND/hugo-backend/static/sh
rsync -az $PATH_TO_DOCS_SOURCE/yaml/ $PATH_TO_DOCS_BACKEND/hugo-backend/static/yaml
rsync -az $PATH_TO_DOCS_SOURCE/images/docs/ $PATH_TO_DOCS_BACKEND/hugo-backend/static/images/docs
rsync -az $PATH_TO_DOCS_SOURCE/images/generic/ $PATH_TO_DOCS_BACKEND/hugo-backend/static/images/generic
  • Go to documentation-backend/hugo-backend and run hugo server -D --config config/latest.toml
  • Open a browser to