From: James Britt <jamesUNDERBARb@...>
Date: 2004-10-27T12:42:51+09:00
Subject: Re: Writing documentation in YAML - any advice?

Its Me wrote:
> "James Britt" <jamesUNDERBARb@neurogami.com> wrote
> 
>>Why not use a document markup language rather than a data markup language?
> 
> 
> Any you would specifically suggest? I find XML (and Docbook etc.) painful in
> a regular text editor, and have not found any reasonable wsywig-ish
> alternatives.

Well, if indeed docbook bothers you, then perhaps plain XHTML, using
class attributes to carry semantic metadata.  Or LaTex.  Or Postscript.

I've found large (100+ lines) YAML files difficult and error-prone to
work with, what with the indentation requirements, and datatype-centric
design, and find the idea of markup-soup perplexing.

I don't see the appeal of embedding HTML or Textile inside of YAML.  You
seem to get the worst of both worlds.

Personal taste, perhaps.

James