Skip to main content

A omni-documentation generation tool that works with any programming language, I hope

Project description

TheDoc

A powerful documentation generation tool that works with any programming language. TheDoc automatically generates comprehensive documentation and release notes based on conventional commits, with seamless MkDocs integration for beautiful web documentation.

Features

  • Language-agnostic code analysis
  • Automatic documentation generation
  • Release notes generation from conventional commits
  • MkDocs integration for web documentation
  • Support for multiple programming languages
  • Customizable documentation templates

Installation

pip install thedoc

Quick Start

  1. Initialize TheDoc in your project:
thedoc init
  1. Generate documentation:
thedoc generate
  1. Generate release notes:
thedoc release-notes
  1. Build MkDocs site:
thedoc build

Development

Setup Development Environment

# Clone the repository
git clone https://github.com/karimomino/thedoc.git
cd thedoc

# Create and activate virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: .\venv\Scripts\activate

# Install development dependencies
pip install -e ".[dev]"

Running Tests

pytest

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

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

thedoc-0.1.0.tar.gz (25.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

thedoc-0.1.0-py3-none-any.whl (19.6 kB view details)

Uploaded Python 3

File details

Details for the file thedoc-0.1.0.tar.gz.

File metadata

  • Download URL: thedoc-0.1.0.tar.gz
  • Upload date:
  • Size: 25.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.6

File hashes

Hashes for thedoc-0.1.0.tar.gz
Algorithm Hash digest
SHA256 e045d5cdaf6f88a3fd9a8a6267cf5a46cc510f9e36159e6a7313767006a4803c
MD5 2c80034133b9521418c3eeaf0876a685
BLAKE2b-256 8a28aed91d46a825bc7900c06c6c11e1a2155fb9d3f8e03cffb2673dae221b2e

See more details on using hashes here.

File details

Details for the file thedoc-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: thedoc-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 19.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.6

File hashes

Hashes for thedoc-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 7c99441c7af39ddd52421f3b42b566ef15a0f46bb48143f289a596afa116e8b3
MD5 ef40bfaabce9dae173ecd0f23960baeb
BLAKE2b-256 b3d81b28c1247aa1b7f1f01b102d00a895778ee8b4756fd06138bdfd46b67eb5

See more details on using hashes here.

Supported by

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