Skip to content

breba-apps/breba-docs

Repository files navigation

Breba Docs · PyPI version

AI documentation validator

workflow

Features

Scans your documentation file and executes commands in the documentation to make sure that it is possible to follow the documentation.

Getting Started

Prerequisites

Docker engine needs to be installed and running. Use docker installation instructions for your system.

Get an OpenAI API Key and set environment variable like this:

export OPENAI_API_KEY=[your_open_ai_api_key]

Install and Run

To install and run breba-docs, run the following commands:

pip install breba-docs
breba-docs

Then you will need to provide location of a documentation file. For example: sample_project/sample.md

The software will then analyze the documentation and run the commands found in the documentation inside a docker container with python installed.

The AI will then provide feedback regarding how it was able to follow the instructions.

Contributing

For contributing to the project, please refer to Contribution Guide.