Kafo

The Puppet Strings JSON output contains per-parameter documentation when given in a YARD format, e.g.

@param example Description of the example parameter

This is exported as:

"tags": [
  {
    "tag_name": "param",
    "text": "Description of the example parameter",
    "types": [
      "..." 
    ],
    "name": "example" 
  }
]

When using this format, the main class docstring wouldn't contain any RDoc either, it would be plain text (possibly with Markdown).

No grouping is supported at the moment (PDOC-123) but the type and conditional could be parsed out of the per-parameter doc string using the same format used in the current RDoc style.