Since we are now migrating 2 specs to asciidoc, it is apropos that I mention this repository:

https://github.com/ingydotnet/yaml-book

This is the start of the YAML book I was writing. It has an asciidoc toolchain, and a nice directory layout. The toolchain was originally handed down to me by Dean Wampler, author of O'Reilly's Scala book. The Scala book was written entirely in this style.

I think all the basic parts to get one started on the spec conversions are there.

Enjoy, Ingy