Starting this thread to discuss changes to puppet doc as was recommended in 
a different thread.

Once I finally got the rdoc documentation generation working, I rather like 
it. Especially when paired with The Foreman.

It would be nice if the help was clearer, and it was easier to find a list 
of the gems/tools that are required to be able to use it. Or better yet, if 
they were included when you installed the puppet package.

Being able to generate PDF files would be very helpful, as they are easy to 
print, and also easy to move around or have as a reference on a mobile 
device (such as phone or personal laptop) that may not have network access 
to the puppet master.

As far as the rdoc thing, it's fine with me, but it would be nice if there 
was a way to scrape params from the classes w/o having to list out each in 
the comments, which I think is part of the actual Ruby rdoc functionality.

- Lee

-- 
You received this message because you are subscribed to the Google Groups 
"Puppet Users" group.
To view this discussion on the web visit 
https://groups.google.com/d/msg/puppet-users/-/SXtkkUteXkUJ.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/puppet-users?hl=en.

Reply via email to