Puppet has a nice module documentation feature outlined here:
http://projects.puppetlabs.com/projects/1/wiki/Puppet_Manifest_Documentation

It would like to be able to retrieve parts of this documentation when calling the puppetclasses api so that it passes it back through json.

http://foreman:port/puppetclasses

So in addition to the name and id that gets returned I would like to see the following at a minimum:

description: "This class installs our default set of users in our servers"

Example:
# Class: users
#
# This class installs our default set of users in our servers
#
# Parameters:
#   $starting_uid:
#       this global variable is used to set the minimum uid used for our users
#
# Actions:
#   Install the default set of users: [dana,fox]
#
# Requires:
#   - Package["zsh"]
#
# Sample Usage:
#