I've pretty much had it with Markdown where table of contents, references, numbering of sections, etc, have to be made by hand. Will transform specs to asciidoc (which is rendered by GitHub) and then generate HTML with some nice scripts and CSS:s.
Tests carried out and HTML looks great. However, GitHub:s viewing of asciidoc files leaves a lot to wish for, so we'll continue using Markdown for a while.
I've pretty much had it with Markdown where table of contents, references, numbering of sections, etc, have to be made by hand. Will transform specs to asciidoc (which is rendered by GitHub) and then generate HTML with some nice scripts and CSS:s.