Overview

AutoMacDoc is an innovative tool designed to simplify the documentation generation process for Python modules and functions. Built on MkDocs and developed in Python, it aims to provide a user-friendly alternative to Sphinx, which is often regarded as overly complex due to its reliance on reStructuredText. With AutoMacDoc, users can seamlessly convert their code folders into beautifully structured Markdown documentation, taking advantage of the simplicity and versatility of Markdown formatting.

The project caters to developers looking for an efficient way to auto-generate documentation, making it accessible even to those who may not be well-versed in complex documentation tools. By offering a streamlined installation process and an intuitive workflow, AutoMacDoc stands out as a practical solution for anyone looking to enhance their Python project's documentation.

Features

Easy Installation: Simply install with pip install automacdoc, making setup quick and hassle-free.
Markdown Generation: Transforms your Python code into clean and organized Markdown documentation that is easy to read and customize.
Automatic Function Listing: Automatically lists all Python functions and classes in the specified folder, saving time and effort in documenting each piece manually.
Structured Output: Creates a 'docs' folder containing all documentation and a 'site' folder for the static site, ensuring a well-organized project structure.
Configurable: Includes a 'mkdocs.yml' configuration file that allows users to tweak their documentation settings easily.
Example Resources: Offers sample folders with additional fancy elements to help users enhance their documentation further.
User-Friendly: Designed with simplicity in mind, making it accessible for developers of all levels to generate quality documentation quickly.

Alexandrekempf

Automacdoc

Svelte Slides