See hlindberg/misc-puppet-docs#8 for a description of how to use the parser/lexer.
As this is a proof of Concept, work will not be done in the master branch and may even be done in a different repo. This project will be worked on during the December 13th hackathon, too.