Documentation assistant will proof read your docs
Project description
Breba Docs
AI documentation validator
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: breba_docs/sample_doc.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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file breba_docs-0.1.7.tar.gz
.
File metadata
- Download URL: breba_docs-0.1.7.tar.gz
- Upload date:
- Size: 11.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/5.1.1 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 874f049778c666da7c14d082902f2db8afc2fda4a4f91ff52d393ae69cf2c27b |
|
MD5 | e4e47d17477f870f448addd6d902539a |
|
BLAKE2b-256 | 03d035b5d005b7d32d808f4d62d4f00d6bae6a7a29499c307a06c3151a2a0676 |
File details
Details for the file breba_docs-0.1.7-py3-none-any.whl
.
File metadata
- Download URL: breba_docs-0.1.7-py3-none-any.whl
- Upload date:
- Size: 14.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/5.1.1 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 11976fb93b918dfd7f3dd16d176050272b28e56584566209411b250253e17b86 |
|
MD5 | 878a742c45d94011aaa8b6e2c6940ddc |
|
BLAKE2b-256 | e8b0d362c5e6ffbad37d0db723424bc9066ce2c7b13fffce581afe70052fd639 |