[tor-bugs] #10978 [Tor bundles/installation]: Decide on a source format for the Tor Browser User Manual

[Tor Bug Tracker & Wiki]

#10978: Decide on a source format for the Tor Browser User Manual
------------------------------------------+----------------------
     Reporter:  lunar                     |      Owner:  lunar
         Type:  task                      |     Status:  accepted
     Priority:  normal                    |  Milestone:
    Component:  Tor bundles/installation  |    Version:
   Resolution:                            |   Keywords:  SponsorO
Actual Points:                            |  Parent ID:  #10974
       Points:                            |
------------------------------------------+----------------------

Comment (by lunar):

 I think Mallard is a very nice markup language and has all the features we
 want:

  * The language is well designed. Its principles are sound and likely to
 create good documentation.
  * Helping translators creating nice translations is all integrated thanks
 to W3C ITS.
  * It supports conditional text for different platforms.
  * It supports integrating outside element pretty easily (like the Tor
 Browser version).

 The only thing we might miss, but I'm not sure, is a single HTML file. We
 could already ship EPUB easily and a single HTML file is only some XSLT
 hacking away.

 Please have a look at [attachment:tor-browser-user-manual-mallard-
 poc.tar:ticket:11124 the proof of concept] and comment.

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