github/markup — pull request #427 by mojavelinux (2014-12-08 09:51:24+00:00)
Title: upgrade to Asciidoctor 1.5.2

Refer to the release notes since 0.1.4 for details:

* http://asciidoctor.org/news/2014/08/12/asciidoctor-1-5-0-released/
* https://github.com/asciidoctor/asciidoctor/releases/tag/v1.5.1
* https://github.com/asciidoctor/asciidoctor/releases/tag/v1.5.2

As always, there are performance improvements for migrating from 0.1.4 to 1.5.2 that will improve GitHub services.

Most of the changes pertain to either the extension mechanism or other features that are not enabled in the GitHub environment. The only major difference that affects GitHub users are the changes to the AsciiDoc syntax. The changes are described in detail on the following migration page: http://asciidoctor.org/docs/migration/.

Users can easily restore "legacy" AsciiDoc syntax parsing by setting the `compat-mode` attribute as described in the migration document. I've decided not to enable `compat-mode` by default to encourage adoption of the more consistent syntax (after all, we changed it for good reason).

If you have any questions about the upgrade, don't hesitate to contact me (just mentioning my username will do the trick).

I do still want to try to improve the rendering of AsciiDoc documents on GitHub, but I don't want to couple that improvement with an upgrade to the latest and greatest Asciidoctor processor.