2008/5/16 David Lutterkort <[EMAIL PROTECTED]>: > > On Thu, 2008-05-15 at 12:04 -0700, Russell Jackson wrote: > > > > I'm not the biggest fan of XML either --as far as writability goes--, but > the flexibility > > that DocBook gives you in the form of output options and the proper > separation of document > > structure and presentation is worth the trouble IMHO. > > Not one to shy away from XML usually, but in this case Docbook XML would > be complete overkill ... writing it is not for the faint at heart, and > several orders of magnitude more complicated than RST.
On the gripping hand... There are XLM editors that take much of the pain away. Templates would allow contributors to add just content. And it's possible to automate simultaneous output HTML/PDF/Manpage etc from a (revision controlled) source. Matthew --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
