On Tue, 2013-02-26 at 10:37 -0500, Michael Goulish wrote: > Phil -- > > Wow, I was thinking of using ASCII.
Markdown is ASCII. > Let me look at Markdown .... hmm, I do like the sound of this: > > "radically simplified and far more human readable form of HTML" > > > But what's the value proposition of using any kind of markup? > Better readability? Linking with other docs? We need to provide docs in HTML and PDF. It is impossible to generate useful HTML or PDF from arbitrarily structured ASCII. > It seems to me that, at least after a build process, we should have > plain ASCII somewhere. Do you agree? Markdown is plain ASCII but with fixed conventions about how to represent headings, bold, italic etc. It is intended to be readable as plain ascii as well as being structured enough to generate HTML etc. > > But it does seem reasonable to do some form of markup as the foundation > and generate other things from there (including flat ASCII). > > > I like the Markdown concept. > ( And I think DocBook is way too heavyweight. ) > ( And I suppose that nothing but flat ASCII is too lightweight. ) > Does anybody else agree ? > Yep. I've never tried it but I think its worth a try. Docbook is a pain. My main concern is how we verify that changes to the doc are valid markdown. Anyone know of approaches to that?
