manual issueshttps://gitlab.torproject.org/tpo/web/manual/-/issues2024-03-26T12:58:53Zhttps://gitlab.torproject.org/tpo/web/manual/-/issues/158Update instructions about using built-in bridges in Tor Browser2024-03-26T12:58:53Zebanamebanam@torproject.orgUpdate instructions about using built-in bridges in Tor Browserhttps://tb-manual.torproject.org/circumvention/
The UX has changed a bit. Let's review and update this section about using built-in bridges with Tor Browser.
> USING PLUGGABLE TRANSPORTS
>
> To use a pluggable transport, click "Configu...https://tb-manual.torproject.org/circumvention/
The UX has changed a bit. Let's review and update this section about using built-in bridges with Tor Browser.
> USING PLUGGABLE TRANSPORTS
>
> To use a pluggable transport, click "Configure Connection" when starting Tor Browser for the first time. Under the "Bridges" section, locate the option "Choose from one of Tor Browser's built-in bridges" and click on "Select a Built-In Bridge" option. From the menu, select whichever pluggable transport you'd like to use.
>
> Once you've selected the pluggable transport, scroll up and click "Connect" to save your settings.
>
> Or, if you have Tor Browser running, click on "Settings" in the hamburger menu (≡) and then on "Connection" in the sidebar. Under the "Bridges" section, locate the option "Choose from one of Tor Browser's built-in bridges" and click on "Select a Built-In Bridge" option. Choose whichever pluggable transport you'd like to use from the menu. Your settings will automatically be saved once you close the tab.
/cc @nina @emmapeelebanamebanam@torproject.orgebanamebanam@torproject.orghttps://gitlab.torproject.org/tpo/web/manual/-/issues/41In https visualization add onion services2024-03-21T18:53:39ZGusIn https visualization add onion servicesFeedback that we got from Frontdesk:
Machine translation:
"I was reading this: http://4bflp2c4tnynnbes.onion/es/https/https-1/
(specifically the diagram)
The diagram is quite good, it explains it excellently, however it would be quite n...Feedback that we got from Frontdesk:
Machine translation:
"I was reading this: http://4bflp2c4tnynnbes.onion/es/https/https-1/
(specifically the diagram)
The diagram is quite good, it explains it excellently, however it would be quite nice to add a switch for the hidden services (.onion).
What things can the hidden services see, because they don't need HTTPS because they are encrypted by default."
"Estaba leyendo esto: http://4bflp2c4tnynnbes.onion/es/https/https-1/
(especificamente el diagrama)
El diagrama está bastante bien, lo explica de forma excelente, sin
embargo estaría bastante bien que se añadiese un interruptor para los
servicios ocultos (.onion). Que cosas pueden ver los servicios
ocultos, debido a que estos no necesitan HTTPS debido a que están
encriptados por defecto."https://gitlab.torproject.org/tpo/web/manual/-/issues/155Update Tor Browser User Manual for the Tor Browser 13.5 release2024-03-18T17:24:36Zebanamebanam@torproject.orgUpdate Tor Browser User Manual for the Tor Browser 13.5 releaseTor Browser tickets for Tor Browser stable 13.5: https://gitlab.torproject.org/tpo/applications/tor-browser/-/issues/?label_name%5B%5D=13.5%20stableTor Browser tickets for Tor Browser stable 13.5: https://gitlab.torproject.org/tpo/applications/tor-browser/-/issues/?label_name%5B%5D=13.5%20stableebanamebanam@torproject.orgebanamebanam@torproject.orghttps://gitlab.torproject.org/tpo/web/manual/-/issues/157Add entry about letterboxing (about:manual#letterboxing)2024-03-12T20:36:03Zma1Add entry about letterboxing (about:manual#letterboxing)We're implementing a `Learn more` link in the new user-facing letteboxing preferences (tpo/applications/tor-browser#41916) and we need some content to be referenced by about:manual#letterboxing :)
@donuts' [comment](https://gitlab.torp...We're implementing a `Learn more` link in the new user-facing letteboxing preferences (tpo/applications/tor-browser#41916) and we need some content to be referenced by about:manual#letterboxing :)
@donuts' [comment](https://gitlab.torproject.org/tpo/applications/tor-browser/-/issues/32324#note_2876483):
> It's on support-dot, but possibly not the manual?
> https://support.torproject.org/tbb/maximized-torbrowser-window/ebanamebanam@torproject.orgebanamebanam@torproject.orghttps://gitlab.torproject.org/tpo/web/manual/-/issues/151Update Tor Browser binary's naming scheme2024-03-12T12:53:53Zebanamebanam@torproject.orgUpdate Tor Browser binary's naming schemeWith Tor Browser 13 (https://gitlab.torproject.org/tpo/applications/tor-browser-build/-/issues/40829), we have a specific naming scheme for Tor Browser binaries. This ticket is to track and update all instances of it in the Manual.With Tor Browser 13 (https://gitlab.torproject.org/tpo/applications/tor-browser-build/-/issues/40829), we have a specific naming scheme for Tor Browser binaries. This ticket is to track and update all instances of it in the Manual.ebanamebanam@torproject.orgebanamebanam@torproject.orghttps://gitlab.torproject.org/tpo/web/manual/-/issues/156New translations available for the manual: tk, ja2024-03-07T16:56:04ZemmapeelNew translations available for the manual: tk, jaThe manual can be released to Turkmen and Japanese, they are 100% translated.The manual can be released to Turkmen and Japanese, they are 100% translated.emmapeelemmapeelhttps://gitlab.torproject.org/tpo/web/manual/-/issues/152Add front desk and cdr.link office hours2024-02-26T17:00:16ZGusAdd front desk and cdr.link office hourshttps://forum.torproject.org/t/psa-updated-tor-user-support-office-hours-2023/9926https://forum.torproject.org/t/psa-updated-tor-user-support-office-hours-2023/9926ebanamebanam@torproject.orgebanamebanam@torproject.orghttps://gitlab.torproject.org/tpo/web/manual/-/issues/73Generate screenshots for the Tor Browser manual2024-01-30T13:45:39ZtraumschuleGenerate screenshots for the Tor Browser manualPreviously screenshots were created with https://github.com/arthuredelstein/tbb-manual-image-creator
This repository needs to be updated to work with Lektor (legacy/trac#24275).
Alternatively [WWW::Mechanize::Firefox](https://metacpan.o...Previously screenshots were created with https://github.com/arthuredelstein/tbb-manual-image-creator
This repository needs to be updated to work with Lektor (legacy/trac#24275).
Alternatively [WWW::Mechanize::Firefox](https://metacpan.org/pod/WWW::Mechanize::Firefox) and [wxpython](https://wiki.wxpython.org/WorkingWithImages#Screen_Capture) may be viable options.Arthur EdelsteinArthur Edelsteinhttps://gitlab.torproject.org/tpo/web/manual/-/issues/99Update known issues page - Tor Browser desktop and mobile2024-01-30T13:40:21ZGusUpdate known issues page - Tor Browser desktop and mobileAccording to the [blog post](https://blog.torproject.org/new-release-tor-browser-105), here's a list of known issues that we need to update the Tor Browser Manual:
### Desktop
- tpo/applications/tor-browser#40497
- tpo/applications/tor...According to the [blog post](https://blog.torproject.org/new-release-tor-browser-105), here's a list of known issues that we need to update the Tor Browser Manual:
### Desktop
- tpo/applications/tor-browser#40497
- tpo/applications/tor-browser#40242
- tpo/applications/tor-browser#40506
- tpo/applications/tor-browser#40510
https://tb-manual.torproject.org/known-issues/
### Mobile
- tpo/applications/fenix#40176
- tpo/applications/fenix#40110
- tpo/applications/fenix#40172
- tpo/applications/fenix#40174
- tpo/applications/fenix#40103
- tpo/applications/fenix#40115
- tpo/applications/fenix#40324
https://tb-manual.torproject.org/mobile-tor/ebanamebanam@torproject.orgebanamebanam@torproject.orghttps://gitlab.torproject.org/tpo/web/manual/-/issues/130Manual on Bridges speaks of "addresses" but means whole bridge lines2024-01-29T19:32:45ZIan Jacksoniwj@torproject.orgManual on Bridges speaks of "addresses" but means whole bridge linesThe page https://tb-manual.torproject.org/bridges/ speaks of "Bridge addresses" but it means the whole bridge line, including not just the address and port but also PT name, identity key, and PT parameters. I think this is unnecessarily...The page https://tb-manual.torproject.org/bridges/ speaks of "Bridge addresses" but it means the whole bridge line, including not just the address and port but also PT name, identity key, and PT parameters. I think this is unnecessarily confusing.
It might even be leading to users fishing the thing out of the bridge line that looks like an address...
Since internally (and presumably in the community) we speak of "bridge lines", maybe that should be the official terminology? Or we could invent a new term ("bridge spec") maybe, but changing existing usage is slow of course.
We should be clear internally about precisely what the terms mean, and use them consistently (for example, the "bridge line" does not seem to include the `Bridge` that appears as the keyword in torrc).https://gitlab.torproject.org/tpo/web/manual/-/issues/154Add anchors to the mobile page to better navigate2023-11-23T15:40:38ZemmapeelAdd anchors to the mobile page to better navigateThe page at https://tb-manual.torproject.org/mobile-tor/ is becoming too big, has many different aspects of TBA. A table of contents with anchors to the different headings would be good, also adding such headers.
For example for the Tro...The page at https://tb-manual.torproject.org/mobile-tor/ is becoming too big, has many different aspects of TBA. A table of contents with anchors to the different headings would be good, also adding such headers.
For example for the Troubleshooting version, to have a link like https://tb-manual.torproject.org/mobile-tor/#troubleshooting , you can add
\<a name="troubleshooting"/\>
Just on top of the Troubleshooting heading.
Same with Known Issues, etc.
This links are also good for SEO
This could be automated with the lektor-markdown-headings pluginhttps://gitlab.torproject.org/tpo/web/manual/-/issues/153improve onion service tb-manual page2023-11-23T15:40:02ZRoger Dingledineimprove onion service tb-manual pageI just did a clean-up of the onion service page in the tb-manual: <br>
https://tb-manual.torproject.org/onion-services/
But three issues remain on that page and could use some more help:
* We devote a good chunk of the page to onion se...I just did a clean-up of the onion service page in the tb-manual: <br>
https://tb-manual.torproject.org/onion-services/
But three issues remain on that page and could use some more help:
* We devote a good chunk of the page to onion service authentication, which I would think is a real edge case. Most users never see that or think about it. Should we move it to the bottom and mark it as an 'advanced situation' or something?
* Our advice if the onion service is gone is to try again later. That's probably bad advice, since probably the story is that the onion service has been gone for years and you are clicking on a thing that will never work. Are we comfortable saying that if it's gone it's probably just gone and you should move on?
* We have this awkward phrase "onion site versions of websites" which might be exactly what our style guide tells us to say, or maybe we can simplify to the smoother "onion versions of websites"? I don't remember what our style guide suggests.
There is also a fourth issue we could consider addressing, https://gitlab.torproject.org/tpo/web/support/-/issues/236, which suggests that we document the magic securedrop names too.https://gitlab.torproject.org/tpo/web/manual/-/issues/146add 'improve translation' button to the manual translation pages2023-11-15T18:31:02Zemmapeeladd 'improve translation' button to the manual translation pagesI'd like to have a button to 'improve translation' added on the content pages of the manual, to help on the maintenance of the translations we have already released. Many times we release translations because they are complete, but when ...I'd like to have a button to 'improve translation' added on the content pages of the manual, to help on the maintenance of the translations we have already released. Many times we release translations because they are complete, but when we update the pages the translations get outdated and we end up having very few translations.
I think if we give other readers the opportunity to maintain the translation, we will have more contributors per language and we will make it easier for translators to make a good translation, as they will be able to go back and forth from the translation platform to the website.emmapeelemmapeelhttps://gitlab.torproject.org/tpo/web/manual/-/issues/110Add Android 12 battery optiization tip2023-11-08T07:17:09ZHackerNCoderhackerncoder@encryptionin.spaceAdd Android 12 battery optiization tipI'm using GrapheneOS which just updated to Android 12, it is even more battery optimizing, to the point where it feels like it is killing Tor Browser in the background by default. Whenever I close the app, and open it again, I have to cl...I'm using GrapheneOS which just updated to Android 12, it is even more battery optimizing, to the point where it feels like it is killing Tor Browser in the background by default. Whenever I close the app, and open it again, I have to click connect. Unless I change the battery optimization level to "Unrestricted".https://gitlab.torproject.org/tpo/web/manual/-/issues/114Explain *why* you would want to make Tor Browser portable2023-11-07T17:02:58ZGusExplain *why* you would want to make Tor Browser portableUser feedback:
The description doesn't explain the value of making Tor Browser portable.
What is the advantage, security and reason for portable?User feedback:
The description doesn't explain the value of making Tor Browser portable.
What is the advantage, security and reason for portable?https://gitlab.torproject.org/tpo/web/manual/-/issues/150[Tor Browser 13 release] Update Tor Browser user manual2023-10-19T23:06:08ZGus[Tor Browser 13 release] Update Tor Browser user manualMain ticket to manage all modifications for the Tor Browser 13 release.Main ticket to manage all modifications for the Tor Browser 13 release.Sponsor 9 - Phase 7 - Usability and Community Intervention on Support for Democracy and Human Rightsebanamebanam@torproject.orgebanamebanam@torproject.orghttps://gitlab.torproject.org/tpo/web/manual/-/issues/148Add country code when asking for private bridges2023-07-14T16:56:11ZGusAdd country code when asking for private bridgesLet's update the documentation page Circumvention to ask users to include their country code when asking a private bridge to front desk and support channels:
```
Users in China will likely have to connect with a private and unlisted obf...Let's update the documentation page Circumvention to ask users to include their country code when asking a private bridge to front desk and support channels:
```
Users in China will likely have to connect with a private and unlisted obfs4 bridge. Contact our Telegram Bot @GetBridgesBot and type /bridges. Or send an email to frontdesk@torproject.org with the phrase "private bridge" in the subject of the email.
```
https://tb-manual.torproject.org/circumvention/championquizzerchampionquizzer@torproject.orgchampionquizzerchampionquizzer@torproject.orghttps://gitlab.torproject.org/tpo/web/manual/-/issues/125Should we keep flash player plugin in "PLUGINS, ADD-ONS AND JAVASCRIPT"?2023-07-13T14:06:28ZcypherpunksShould we keep flash player plugin in "PLUGINS, ADD-ONS AND JAVASCRIPT"?Page "PLUGINS, ADD-ONS AND JAVASCRIPT" says about Flash Player. Should it really be mentioned now, when Flash Player is deprecated, stopped working and nobody is using it?Page "PLUGINS, ADD-ONS AND JAVASCRIPT" says about Flash Player. Should it really be mentioned now, when Flash Player is deprecated, stopped working and nobody is using it?GusGushttps://gitlab.torproject.org/tpo/web/manual/-/issues/149improve instructions to 'Prioritize .onion sites'2023-07-11T08:54:12Zchampionquizzerchampionquizzer@torproject.orgimprove instructions to 'Prioritize .onion sites'A translator has reported:
> Currently on Windows, the suggested menu-address is "Settings" rather than Options.A translator has reported:
> Currently on Windows, the suggested menu-address is "Settings" rather than Options.championquizzerchampionquizzer@torproject.orgchampionquizzerchampionquizzer@torproject.orghttps://gitlab.torproject.org/tpo/web/manual/-/issues/142Google Play instructions need updating2023-07-03T14:48:49ZemmapeelGoogle Play instructions need updatingreported by translator olavinto, thanks!
The instructions for updating and uninstalling tor Browser with Google Play at
https://gitlab.torproject.org/tpo/web/manual/-/blob/main/content/mobile-tor/contents.lr
Need to be updated:
```...reported by translator olavinto, thanks!
The instructions for updating and uninstalling tor Browser with Google Play at
https://gitlab.torproject.org/tpo/web/manual/-/blob/main/content/mobile-tor/contents.lr
Need to be updated:
```
12:09 < olavinto[m]> * This phrase: "Tap on the hamburger menu next to the search bar and navigate to "My apps & games" >
"Installed". Select Tor Browser from the list of installed apps, then press the "Uninstall" button." has not been
exactly accurate for a while. The hamburger menu is still there although these days it's the logged in user's
icon and "My apps & games" has been "Manage apps and device" for a long time, and lastly, there is no "Installed"
12:09 < olavinto[m]> section under it anymore either but isntead there is a "Manage" (not the default tab, default is an overview) tab
and an "Installed" filtering option under that. Mainly that.
12:16 < olavinto[m]> Basically the whole section related to uninstalling the mobile app via Google Play now reads about like this in
Finnish: "Tap the user icon next to the search bar and select "Maintain apps and devices" > "Maintenance" from
the menu that opens. By default, the filtering options at the top are set to show only apps for which an update
is available. You can also search for Tor browser from the search field on the front page if you have a lot
12:16 < olavinto[m]> of applications on your device."
12:19 < olavinto[m]> s/By default, the filtering options at the top are set to show only apps for which an update is available.//
```championquizzerchampionquizzer@torproject.orgchampionquizzerchampionquizzer@torproject.org