Doing a puppet strings generate manifests/init.pp generates the documentation, but the included file is included verbatim. The @param reference and everything still stays there. If I'd copy the whole documentation into init.pp, too, the YARD-tags are recognized, but I want the class documentation to go separately. I hardly want 800 lines of documentation in front of my 400 line class. It's already big enough!