Please remove me from mailing list Tanveer Ahmad
Lecturer, School of Technology St Patricks International College 48 Carey Street New Court London WC2A 2JE United Kingdom www.st-patricks.ac.uk ________________________________________ From: sebb <[email protected]> Sent: 06 October 2013 13:16 To: Maven Developers List Subject: Re: [DISCUSS] Converting site documentation to Markdown Regarding automatic conversion to Markdown: The main ASF site was converted from xdoc to Markdown. Some tools werr written for this, but they were not 100% accurate; we were still finding conversion issues a year or so later. [We've probably not found them all yet] Whether these conversion issues are important is another matter, but there are certainly some area such as the license pages where it is vital that the conversion is accurate -- and problems were found there. AFAIR, Markdown still has some areas where it is weak - for example numeric lists, which was one of the license page issues. The existing HTML documentation is presumably all in SCM, so it should be possible to compare the new with the old if necessary. And if layout etc problems are detected later, the originals should be available. Might be worth creating tags for the source and generated HTML just before and after conversion to make it easier to dig into the history later. On 6 October 2013 10:13, Kristian Rosenvold <[email protected]> wrote: > 2013/10/6 Stephen Connolly <[email protected]>: >>> IMHO >>> >>> Betamax == AsciiDoc >>> VHS == MarkDown > > Being a bunch of old geezers, we all know which was technically superior. > > I had to teach my oldest kid how to operate a non-mobile phone the > other day (she dialled number before lifting the handset) > > Kristian > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [email protected] > For additional commands, e-mail: [email protected] > --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
