/stibnite

Automated python documentation generator

Primary LanguagePythonApache License 2.0Apache-2.0

Banner

Latest release Latest release License Repo contributors Repo branch checks state Feature request issues GitHub Repo stars Progress of the next release


Stibnite is an automated documentation generator that can work with different docstring styles. (and hopefully in the future different programming languages)

Report Bug · Request Feature

Table of Contents

About The Project

Stibnite is a powerful tool that can create a website for the documentation of your codebase by parsing python files (for now), extracting docstrings from functions, classes, methods and, etc. and creating a stylized markdown based webpage using mkdocs.

Features

It can

  • parse python files to extract docstrings
  • parse docstrings to create a webpage
  • create a website out of your codebase
  • customize the output based on your choices
  • ignore the files that you don't want them to be in the documentation
Supported Languages
  • Python
Supported Docstring Styles
  • reStructured Text
  • Markdown

Installation

The easiest way to install this tool is via pip

pip install stibnite

Usage

Still in development process

Roadmap

Our vision for this project is to create a tool that can automatically create a customizable documentation in every possible language with every possible docstring style to free the software developers from the burden of writing dreaded documentation.

You can reach what we are planning for our next version in here

License

Distributed under the Apache 2.0 License. See LICENSE for more information.

Contact

Discord Linkedin Izzet Linkedin Tolga

Disclaimer

As the developers of this project we take it as one's duty to thank AlexandreKempf and other contributers in the automacdoc project as they are the visionary fathers/mothers of stibnite and Hikmet Dogan for his beautiful work on our logo.

made with built with powered by