api-tools-0.8.0.1: DSL for generating API boilerplate and docs

Safe HaskellNone
LanguageHaskell2010

Data.API.Markdown

Description

This module generates Markdown-formatted documentation for an API, like this:

### Foo

a test defn

JSON Type : **union object** (Haskell prefix is 'foo')

| Alternative | Type    | Comment
| ----------- | ------- | -----------
| _`Baz`_     | boolean | just a bool
| _`Qux`_     | integer | just an int

Synopsis

Documentation

markdown :: MarkdownMethods -> API -> MDComment Source #

Create human-readable API documentation in Markdown format

thing :: MarkdownMethods -> Thing -> MDComment -> MDComment Source #

Document a single API comment or node in Markdown format