[tor-bugs] #11698 [Tor bundles/installation]: Decide how to incorporate Tor Browser Manual pages into Tor Browser

[Tor Bug Tracker & Wiki]

#11698: Decide how to incorporate Tor Browser Manual pages into Tor Browser
------------------------------------------+--------------------------------
     Reporter:  mttp                      |      Owner:
         Type:  defect                    |     Status:  new
     Priority:  normal                    |  Milestone:
    Component:  Tor bundles/installation  |    Version:
   Resolution:                            |   Keywords:  tbb-manual,
Actual Points:                            |  SponsorO
       Points:                            |  Parent ID:  #10974
------------------------------------------+--------------------------------

Comment (by lunar):

 Replying to [comment:6 mttp]:
 > Here's my concern: the user downloads Tor Browser. After it's installed,
 she clicks on the HTML files she finds to read them. Her default browser
 opens. The user mistakes the default browser for Tor Browser, and begins
 browsing, thinking she is anonymous.
 https://trac.torproject.org/projects/tor/ticket/10399 is not-entirely
 unrelated.
 >
 > I could see this situation arising especially in cases where Tor Browser
 fails to open. When users are frustrated, they prioritize getting online
 above thinking through the possible technical issues. A frustrated user is
 more likely to convince herself that her problem has been solved "somehow"
 when it hasn't been. The familiar browser interface and network
 capabilities contribute to her confusion.

 Understood. How about having a specific HTML file to offer the manual
 outside the Tor Browser that
 would contain an `<iframe>` surrounded with “Tor Browser User Manual” and
 a big fat warning “This is only the manual, not the actual Tor Browser.
 This browser provides no anonymity.”? I guess we could even
 [https://developer.mozilla.org/en-US/docs/Web/API/window.onbeforeunload
 use JavaScript to provide a warning] if users try to browse somewhere
 else.

 I'm not necessarily opposed to a PDF, but I fear that it will be far less
 convenient to read given Mallard's design goals.

 Replying to [comment:7 mcs]:
 > Note that after #11641 is fixed, the Docs subdirectory will be a little
 harder to find (on Linux and Windows it will be inside Browser/TorBrowser/
 and on Mac OS it will be inside Tor Browser.app/TorBrowser/). We could add
 an "Open Docs Folder" button to Tor Launcher's setup wizard if we can find
 a place for it in the UI.

 We can still make a shortcut/symlink in the main folder to something
 deeper in the tree, right?

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