[Pacemaker] Documentation challenge

[Andrew Beekhof]

On Mon, Oct 19, 2009 at 12:19 PM, Florian Haas <florian.haas at linbit.com> wrote:
>> [1] Remember how much you didn't writing a few dozen lines of
>> configuration in XML?
>> Consider how unenthusiastic I might be to write massive slabs of text
>> with it ;-)
>> The XML for "Configuration Explained" alone is 4700 un-wrapped lines long.
>
> XML is a markup language, and it was created for documents,

Just not for the authors of said documents.

> which it
> remains infinitely better suited for than for configuration files

Complete nonsense ;-)

> (where
> people really need to modify the markup

As opposed to putting the right tags in the right place with the right
options in docbook?
Surely you jest.

> -- it's perfectly OK to just use
> XML as an internal config format and have a sensible front end to modify
> it). So users do get to complain about having to hack markup. Tech
> writers do not. :)

I'm no tech writer, but I do appreciate your docbook hints :-)