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 seb...@gmail.com
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
kristian.rosenv...@gmail.com wrote:
2013/10/6 Stephen Connolly stephen.alan.conno...@gmail.com:
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: dev-unsubscr...@maven.apache.org
For additional commands, e-mail: dev-h...@maven.apache.org
-
To unsubscribe, e-mail: dev-unsubscr...@maven.apache.org
For additional commands, e-mail: dev-h...@maven.apache.org
-
To unsubscribe, e-mail: dev-unsubscr...@maven.apache.org
For additional commands, e-mail: dev-h...@maven.apache.org