On Oct 26, 2008, at 1:40 PM, Brice Figureau wrote: > Hi, > > OK, I made some good progress on the subject, and will publish some > patches later this week or on next week-end, to gather comments/ > reviews > and directions to where to head this project. > > So far, the system does the following: > * it can produce html based on RDoc for a modulepath or a module. It > produces exactly the same thing as RDoc for ruby except that it shows > defines where the ruby versions shows methods. My ultimate plan > would be > to change the output to something more puppet oriented, which would > also > contains more documentated types (resource collections, virtual > resources, class included, imports...) > > * and if rdoc is not an option, it can produce html using markdown > (rdiscount in fact) for a module or modulepath. It produces a > hierarchy > of directories (one per module) containing html files in it (one per > class or define). That's not really usefull as there is no > cross-reference, nor index. This part is still rough and doesn't bring > anything more than the RDoc version (except it doesn't use rdoc:-)). > > It yet does support documenting only classes and defines. > I think I'll release it like that, and from there we'll see how we can > refine it and move toward something usefull.
That sounds like a great start; awesome. -- Yesterday upon the stair I met a man who wasn't there. He wasn't there again today -- I think he's from the CIA. --------------------------------------------------------------------- Luke Kanies | http://reductivelabs.com | http://madstop.com --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "Puppet Developers" group. 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-dev?hl=en -~----------~----~----~----~------~----~------~--~---
