On Thu, May 8, 2008 at 12:39 PM, Luke Kanies <[EMAIL PROTECTED]> wrote: > The bug tracker isn't that great, I must say.
Man am I glad to read that. I completely agree. This seems like a separate issue though. What's being considered for this? Bugzilla? It's the only one I've seen that doesn't suck, but there's always new stuff out there. > Steven Jenkins encouraged the use of MediaWiki, but one of my primary > requirements of any choice is that we don't pick a format that's not > at least pretty close to a standard. MediaWiki's format is pretty ad- > hoc, and no one but MediaWiki uses it. There aren't external parsers, > I can't easily convert it to a PDF, etc. Yea, I too am a MediaWiki fanboy and it's untrue that there aren't other parsers for it (http://pear.php.net/package/Text_Wiki_Mediawiki for example). There's also http://wiki.opengarden.org/Deki_Wiki Which is getting a lot of positive WoM lately. We use MediaWiki for our internal documentation and are very very happy with its featureset. While it's true that Wikis don't impose structure, that doesn't mean you can't have wiki-nazis that organize things for you. I have the great luck of being that person at my work and would love to volunteer to help with the puppet one, but having just lost 2/12 of our team (and the exact wrong two) we're completely crushed. If you really want to solve the format conversion problem, I think wikis aren't the way to go. In researching this stuff for my own projects, it seems like, as horrid as it is, Docbook is the best thing going. And also, it seems like if you get a wiki/whatever you like, problem solved. While it'd be great to have off-line docs, they aren't (obviously) essential. -Sam --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
