Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/databio/lucidoc

Automatic python documentation in markdown for mkdocs
https://github.com/databio/lucidoc

Last synced: about 1 month ago
JSON representation

Automatic python documentation in markdown for mkdocs

Awesome Lists containing this project

README

        

# lucidoc

[![Build Status](https://travis-ci.org/vreuter/lucidoc.svg?branch=master)](https://travis-ci.org/vreuter/lucidoc)
[![Coverage Status](https://coveralls.io/repos/github/vreuter/lucidoc/badge.svg?branch=master)](https://coveralls.io/github/vreuter/lucidoc?branch=master)

Lucidoc is a Python package that makes it easier to automatically document Python packages. It is specifically useful for documenting Python packages using `mkdocs`.

It parses Python docstrings and uses them to autogenerate a package API documentation page in `markdown` format. Since `lucidoc` outputs `markdown` format, it's convenient to link with `mkdocs` for building automatic documentation web pages.