search

matatk / agrip

AGRIP AudioQuake and Level Description Language (LDL)
http://agrip.org.uk
Other
16 stars 6 forks source link

Consider AsciiDoc for documentation #35

Closed matatk closed 4 years ago

matatk commented 7 years ago

I did convert the DocBook XML manuals to Markdown and have incorporated the conversion into the build process in a cross-platform way, but...

Just discovered AsciiDoc, which was designed to be a plain-text shorthand for DocBook, which means that DocBook's semantics are preserved. This feels like a more apt transition, considering the effort that was put into the DocBook documentation to start with, and maybe it would make the conversion more reliable.

More info:

matatk commented 4 years ago

Going to K.I.S.S. for now; #47 settled on GFM.