The docs directory in the ksqlDB repo contains the markdown files and other source content for the ksqlDB docs.

You can help to improve the ksqlDB documentation by contributing to this repo:

• Open a GitHub issue and give it the documentation label.
• Submit a pull request with your proposed documentation changes.
• Get started with writing and formatting on GitHub.

It's easy to build the documentation on your local machine, so you can preview as you write.

To build the docs on your local machine:

• Install Python 3.7 or higher: Properly Installing Python
• Install Pip: Installation
• Clone the ksqlDB repo.

The ksqlDB documentation uses the MkDocs static site generator to build the docs site.

With Python and pip installed, use the following command to install mkdocs.

pip install mkdocs

For more information, see Installation.

The ksqlDB documentation build uses these plugins and extensions:

• mdx_gh_links: shorthand links to GitHub
• mkdocs-macros-plugin: variables and macros
• mkdocs-git-revision-date-plugin: page last updated in GitHub
• pymdown-extensions: adds features to the standard Python Markdown library
• mkdocs-material: docs site theme
• mkdocs-redirects: redirects for moved content
• mdx-truly-sane-lists: improved list formatting

These dependencies and the required versions are listed in the requirements.txt file in the docs directory.

Install the plugins and extensions by using the pip installer:

pip install -r docs/requirements.txt

In your local clone of the ksqlDB repo, build the docs and start a server to enable viewing them:

mkdocs serve

Open a web browser to http://127.0.0.1:8000 to view the docs. Keep the server running, and it will detect file changes as you edit and automatically rebuild when you save a file.