[tor-bugs] #25519 [Core Tor/Tor]: move away from asciidoc

[Tor Bug Tracker & Wiki]

#25519: move away from asciidoc
----------------------------------+----------------------------------
 Reporter:  dkg                   |          Owner:  (none)
     Type:  task                  |         Status:  new
 Priority:  Medium                |      Milestone:  Tor: unspecified
Component:  Core Tor/Tor          |        Version:
 Severity:  Normal                |     Resolution:
 Keywords:  035-removed-20180711  |  Actual Points:
Parent ID:                        |         Points:
 Reviewer:                        |        Sponsor:
----------------------------------+----------------------------------

Comment (by catalyst):

 Asciidoc's successor appears to be [https://asciidoctor.org/ Asciidoctor].
 Unfortunately there seem to be some tools out there that claim to support
 Asciidoc but really support Asciidoctor and don't have full Asciidoc
 support. There are some nontrivial differences in the syntax.

 We discovered this during some Google Season of Docs work, when we noticed
 that the Asciidoc preview and editing plugins for the Atom editor actually
 support Asciidoctor rather than Asciidoc. This led to some divergence of
 expectations about what the rendered output would look like.

 Does anyone know of a reason we should not migrate to Asciidoctor at some
 point? It seems less troublesome than migrating to a completely different
 kind of markdown.

--
Ticket URL: <https://trac.torproject.org/projects/tor/ticket/25519#comment:8>
Tor Bug Tracker & Wiki <https://trac.torproject.org/>
The Tor Project: anonymity online