[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:  new
 Priority:  normal                    |      Milestone:
Component:  Tor bundles/installation  |        Version:
 Keywords:  SponsorO                  |  Actual Points:
Parent ID:  #10974                    |         Points:
--------------------------------------+-----------------------
 In order to turn the “short user manual” into the Tor Browser User Manual,
 we need to decide on a source format before starting the conversion.

 Requirements:

  * It needs be able to generate HTML. Ideally HTML that will embed CSS and
 images directly.
  * It needs either be directly understood by Transifex or by
 [http://po4a.alioth.debian.org/ po4a] in order to be translatable.
  * It needs to directly support or be easily scriptable in order to have
 conditional sections depending on the operating system and the target
 language.
  * It needs to be plain text as we want to be able to have Git reviews.

 The discussion is inherently tied to the tools that are able to convert
 that format to something else…

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