Skip to main content

Documentation assistant will proof read your docs

Project description

Breba Docs

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: 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

breba_docs-0.1.7.tar.gz (11.0 kB view details)

Uploaded Source

Built Distribution

breba_docs-0.1.7-py3-none-any.whl (14.5 kB view details)

Uploaded Python 3

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

Hashes for breba_docs-0.1.7.tar.gz
Algorithm Hash digest
SHA256 874f049778c666da7c14d082902f2db8afc2fda4a4f91ff52d393ae69cf2c27b
MD5 e4e47d17477f870f448addd6d902539a
BLAKE2b-256 03d035b5d005b7d32d808f4d62d4f00d6bae6a7a29499c307a06c3151a2a0676

See more details on using hashes here.

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

Hashes for breba_docs-0.1.7-py3-none-any.whl
Algorithm Hash digest
SHA256 11976fb93b918dfd7f3dd16d176050272b28e56584566209411b250253e17b86
MD5 878a742c45d94011aaa8b6e2c6940ddc
BLAKE2b-256 e8b0d362c5e6ffbad37d0db723424bc9066ce2c7b13fffce581afe70052fd639

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page