On Tue, Oct 7, 2014 at 5:20 PM, Herbert Valerio Riedel wrote: > Hello GHC Developers & GHC User's Guide writers, > > I assume it is common knowledge to everyone here, that the GHC > User's Guide is written in Docbook XML markup. > > However, it's a bit tedious to write Docbook-XML by hand, and the > XML markup is not as lightweight as modern state-of-the-art markup > languages designed for being edited in a simple text-editor are. > > Therefore I'd like to hear your opinion on migrating away from the > current Docbook XML markup to some other similarly expressive but > yet more lightweight markup documentation system such as Asciidoc[1] > or ReST/Sphinx[2]. > > There's obviously some cost involved upfront for a (semi-automatic) > conversion[3]. So one important question is obviously whether the > long-term benefits outweight the cost/investment that we'd incur for > the initial conversion. > > All suggestions/comments/worries welcome; please commence > brainstorming :)
Given the choices (and existing Docbook files), I would select AsciiDoc. _______________________________________________ ghc-devs mailing list ghc-devs@haskell.org http://www.haskell.org/mailman/listinfo/ghc-devs
