Yes, if I were starting today I'd have written it in asciidoc. But the spec is almost 10 years old, asciidoc wasn't around when we started (AFAIK).

Have fun,

    Oren Ben-Kiki

On Tue, Oct 25, 2011 at 4:49 PM, Trans <> wrote:

On Oct 25, 1:26 am, Ingy dot Net <> wrote:
> Greetings,
> Thank you for taking the time to make these suggestions. My first thought
> was that the spec authoring/maintenance should be a more open process. My
> second thought was that we really should have the spec on github, so people
> could file issues, fork the spec, and send pull requests. My third thought
> was realizing this:

It would help if one could make any sense of all that. I wouldn't even
no where to start. Guess I now know why people tend to mention DocBook
as it were the epitome of barfing.

At the very least could some appropriate subdirs be used?

The demand for IT networking professionals continues to grow, and the
demand for specialized networking skills is growing even more rapidly.
Take a complimentary Learning@Cisco Self-Assessment and learn
about Cisco certifications, training, and career opportunities.
Yaml-core mailing list