Am 14.11.2011 23:41, schrieb Anthony Liguori:
Right now our specs are written in psuedo-wiki syntax. This series converts
them to markdown. markdown is a simple markup format that's gaining in
popularity.
The big advantage of using markdown is that there are tools that can convert it
to relatively simple HTML. That means we can build a make infrastructure that
generates a nice set of static web pages.
The syntax is also more human friendly than mediawiki syntax.
To see what the stylized version of this looks like, check out:
https://github.com/aliguori/qemu/tree/markdown/docs/specs
Maybe the file names could also be cleaned: either remove _spec
as it is not needed (or do you add _src to source file names),
or add it to all file names.
Regards,
Stefan Weil
