Strimzi documentation

Welcome to the Strimzi documentation!

This folder contains the source files for managing the Strimzi documentation. The documentation is written in AsciiDoc, and it covers guides to help you understand, deploy, and configure Strimzi.

Table of Contents

• Strimzi guides
• Documentation folder structure
• Contributing to the documentation

Strimzi guides

The Strimzi documentation is organized into the following guides:

• Overview guide

  • Files: /documentation/overview/
  • This guide provides an overview of Strimzi, explaining its key concepts and features.

• Deploying and Managing Strimzi guide

  • Files: /documentation/deploying/
  • This guide provides instructions and best practices for deploying and managing Strimzi.

• API Reference

  • Files: /documentation/configuring/
  • This guide provides detailed information on configuring Strimzi through its API.

Documentation folder structure

The content for each Strimzi guide is encapsulated in a main source file:

• overview/overview.adoc - Overview guide
• deploying/deploying.adoc - Deploying and Managing Strimzi guide
• configuring/configuring.adoc - API Reference

The main source files are used to build the documentation and are contained in separate folders. Other documentation folders contain the content that's incorporated into the main source files.

Documentation folders

Folder	Description
api/	Property descriptions for the API Reference guide
contributing/	Documentation Contributor Guide
deploying/	Deploying and Managing Strimzi guide (main)
overview/	Strimzi Overview guide (main)
configuring/	API Reference (main)
assemblies/	Assemblies (chapters) provide content for all guides
modules/	Modules provide content for assemblies
shared/	Shared include files
shared/attributes.adoc	Global book attributes
shared/images/	Shared image files

Contributing to the documentation

If there's something that you want to add or change in the documentation, do the following:

1. Set up a local Git repository
2. Create a branch for your changes
3. Add the changes through a pull request

The pull request will be reviewed and the changes merged when the review is complete. The guide is then rebuilt and the updated content is published on the Strimzi website. Published documentation for the current main branch as well as all releases can be found on our website.

For more information on setting up and contributing to the documentation, see the Strimzi documentation contributor guide.