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.
I couldn't think of much at all, I'm afraid. From my POV before working with DocBook, the only points which I could think of were: (1) It's easier to be sure you're working with a valid AsciiDoc document because the structural elements don't have to be explicitly set - e.g. there's no need for <para> tags etc. Changing a paragraph in AsciiDoc into a section is a simple matter of adding the appropriate markup (e.g. ========== ). (2) AsciiDoc requires only a very low level of entry knowledge; (3) AsciiDoc has very few dependencies in converting docs from its native format into ePub, HTML, PDF etc. Are the other points that I am missing? Note that I'm not looking to change the method by which I work now since there are many more people than myself involved. I also have no interest in starting a flame war. I am simply curious to know what advantages others see in AsciiDoc. I was prompted to write this both by the discussion at work, also the posting by O'Reilly about their use of AsciiDoc in producing some books. -- 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.
