On 2012-03-13, Russell Dickenson <[email protected]> wrote:
> Although I have some familiarity with AsciiDoc, having used it for
> some simple documentation, I don't know it well. A discussion came up
> at work recently about the possible advantages of markup languages
> such as AsciiDoc and wiki syntaxes over DocBook, which is what we use
> here at work.
To me, the main advantage is that unless you're trying to do some
pretty fancy stuff, Asciidoc doesn't look marked up.
In most cases, an unprocessed Asciidoc is perfectly usable as
documentation by somebody with nothing more than a text editor or a
copy of "less".
Somebody can open a Readme.txt file that's in Asciidoc format and just
read it as-is.
I've never seen Docbook source that wasn't somewhat painful to read.
--
Grant Edwards grant.b.edwards Yow! I selected E5 ... but
at I didn't hear "Sam the Sham
gmail.com and the Pharoahs"!
--
You received this message because you are subscribed to the Google Groups
"asciidoc" 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/asciidoc?hl=en.
