manual issueshttps://gitlab.torproject.org/tpo/web/manual/-/issues2021-07-08T14:22:07Zhttps://gitlab.torproject.org/tpo/web/manual/-/issues/93v2 onion services deprecation and documentation review2021-07-08T14:22:07ZGusv2 onion services deprecation and documentation reviewAs v2 onion services are deprecating soon, let's review all the Onion Services page in TB-Manual and make sure the documentation points to v3 information.
For example:"An onion address is a string of 16 (and in V3 format, 56) mostly rand...As v2 onion services are deprecating soon, let's review all the Onion Services page in TB-Manual and make sure the documentation points to v3 information.
For example:"An onion address is a string of 16 (and in V3 format, 56) mostly random letters and numbers...", now we should say "a string of 56 mostly random letters and numbers...".
Let's use this ticket to review the page and track all the changes the need to be done.
https://tb-manual.torproject.org/onion-services/Tor Browser: 10.5GusGushttps://gitlab.torproject.org/tpo/web/manual/-/issues/92Tor Browser launcher removal2021-07-09T18:55:12ZGusTor Browser launcher removalAs TB 10.5 will remove the Tor Browser launcher, we need to find all the occurrences in the documentation and update it.
This ticket will track all the changes that need to happen in TB-Manual.
### Running Tor Browser
http://dsbqrprgk...As TB 10.5 will remove the Tor Browser launcher, we need to find all the occurrences in the documentation and update it.
This ticket will track all the changes that need to happen in TB-Manual.
### Running Tor Browser
http://dsbqrprgkqqifztta6h3w7i2htjhnq7d3qkh3c7gvc35e66rrcv66did.onion/running-tor-browser/
- [ ] Screenshots: update [Connect](http://dsbqrprgkqqifztta6h3w7i2htjhnq7d3qkh3c7gvc35e66rrcv66did.onion/static/images/connect.png), update [Configure](http://dsbqrprgkqqifztta6h3w7i2htjhnq7d3qkh3c7gvc35e66rrcv66did.onion/static/images/configure.png), [remove Proxy question](http://dsbqrprgkqqifztta6h3w7i2htjhnq7d3qkh3c7gvc35e66rrcv66did.onion/static/images/proxy_question.png), update [Pluggable Transport](http://dsbqrprgkqqifztta6h3w7i2htjhnq7d3qkh3c7gvc35e66rrcv66did.onion/static/images/pluggable-transport.png)
- [ ] Update text to reflect new connecting experience
- [ ] Proxy: update text and [screenshot](http://dsbqrprgkqqifztta6h3w7i2htjhnq7d3qkh3c7gvc35e66rrcv66did.onion/static/images/proxy.png) when using a proxy
### Circumvention
http://dsbqrprgkqqifztta6h3w7i2htjhnq7d3qkh3c7gvc35e66rrcv66did.onion/circumvention/
- [ ] We don't have "Tor is censored in my country" checkbox. Remove or update this text:"After checking the checkbox "Tor is censored in my country," choose the "Select a built-in bridge" option."
### Bridges
http://dsbqrprgkqqifztta6h3w7i2htjhnq7d3qkh3c7gvc35e66rrcv66did.onion/bridges/
- [ ] Remove text: "After checking the checkbox 'Tor is censored in my country,' "
- [ ] Remove "Tor Launcher" reference from:"Once you have obtained some bridge addresses, you will need to enter them into Tor Launcher."
- [ ] Remove text: "After checking the checkbox 'Tor is censored in my country,' "
### Troubleshooting
http://dsbqrprgkqqifztta6h3w7i2htjhnq7d3qkh3c7gvc35e66rrcv66did.onion/troubleshooting/
- [ ] Update screenshot - http://dsbqrprgkqqifztta6h3w7i2htjhnq7d3qkh3c7gvc35e66rrcv66did.onion/static/images/connect.pngTor Browser: 10.5GusGushttps://gitlab.torproject.org/tpo/web/manual/-/issues/111tor-browser-manual.torproject.org: migrate from Jenkins to GitLab CI2021-11-04T00:24:15Zanarcattor-browser-manual.torproject.org: migrate from Jenkins to GitLab CI* [x] include ci-templates `lektor.yml` job
* [x] site builds and works in gitlab pages
* [x] [add the deploy-static job and SSH key to GitLab CI](https://gitlab.torproject.org/tpo/tpa/team/-/wikis/service/static-shim#deploying-a-static-...* [x] include ci-templates `lektor.yml` job
* [x] site builds and works in gitlab pages
* [x] [add the deploy-static job and SSH key to GitLab CI](https://gitlab.torproject.org/tpo/tpa/team/-/wikis/service/static-shim#deploying-a-static-site-from-gitlab-ci)
* [x] [deploy the SSH key and static site in Puppet](https://gitlab.torproject.org/tpo/tpa/team/-/wikis/service/static-shim#adding-a-new-static-site-shim-in-puppet)
* [x] run the deploy-static job, make sure the site still works and was deployed properly (`curl -sI https://tb-manual.torproject.org/ | grep -i Last-Modified`)
* [x] [archive the repo on gitolite](https://gitlab.torproject.org/tpo/tpa/team/-/wikis/howto/gitlab/#how-to-migrate-a-git-repository-from-legacy-to-gitlab)
* [x] remove the old site on staticiforme
* [x] [fully retire the Jenkins jobs](https://gitlab.torproject.org/tpo/tpa/team/-/wikis/service/jenkins#removing-a-job)
* [x] notify users about the migrationRetire Jenkinsanarcatanarcathttps://gitlab.torproject.org/tpo/web/manual/-/issues/144Add Kiswahili translation2023-05-22T06:54:00ZemmapeelAdd Kiswahili translationWe are almost ready to release the Kiswahili translation.
We only need to fix some strings, and the review.We are almost ready to release the Kiswahili translation.
We only need to fix some strings, and the review.Sponsor 134: Localizing Tor tools and documentation into Arabic, Chinese, and Swahiliemmapeelemmapeel2023-05-22https://gitlab.torproject.org/tpo/web/manual/-/issues/119Update the manual for Tor Browser 11.5 release2022-07-15T18:25:15ZGusUpdate the manual for Tor Browser 11.5 releaseNew features:
- connect:assist - it will be available this week on TB Alpha - https://gitlab.torproject.org/tpo/applications/tor-browser/-/issues?scope=all&state=opened&search=torconnect
- Connection test
- HTTPS-Only Mode (about:prefer...New features:
- connect:assist - it will be available this week on TB Alpha - https://gitlab.torproject.org/tpo/applications/tor-browser/-/issues?scope=all&state=opened&search=torconnect
- Connection test
- HTTPS-Only Mode (about:preferences#privacy)
- New bridges configuration page
- Bridges emoji identification and QRcodeSponsor 96: Rapid Expansion of Access to the Uncensored Internet through Tor in China, Hong Kong, & Tibetchampionquizzerchampionquizzer@torproject.orgchampionquizzerchampionquizzer@torproject.orghttps://gitlab.torproject.org/tpo/web/manual/-/issues/89Deploy Tor Browser User Manual on Gitlab.com2022-07-08T14:04:50ZGusDeploy Tor Browser User Manual on Gitlab.comAt the moment, the Tor Browser User Manual is only accessible on the subdomain: tb-manual.torproject.org. But, thinking about users living in countries that are blocking the torproject.org main domain, they can't access this documentatio...At the moment, the Tor Browser User Manual is only accessible on the subdomain: tb-manual.torproject.org. But, thinking about users living in countries that are blocking the torproject.org main domain, they can't access this documentation. Since Lektor is a static generator site, it's possible to host this documentation on gitlab.com, which isn't censored (in most cases).
Tasks
* [x] Write a CI/CD and deploy this manual on gitlab.com pages. See: https://gitlab.torproject.org/tpo/web/team/-/issues/4Sponsor 96: Rapid Expansion of Access to the Uncensored Internet through Tor in China, Hong Kong, & Tibethttps://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/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/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/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/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/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/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/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/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/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/147Update Tor Browser User Manual for the Tor Browser 12.5 release2023-06-20T14:34:20Zchampionquizzerchampionquizzer@torproject.orgUpdate Tor Browser User Manual for the Tor Browser 12.5 releaserelated to: https://gitlab.torproject.org/tpo/community/support/-/issues/40113related to: https://gitlab.torproject.org/tpo/community/support/-/issues/40113championquizzerchampionquizzer@torproject.orgchampionquizzerchampionquizzer@torproject.orghttps://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/145Improve this phrase in TB mobile manual2023-06-20T18:34:40ZGusImprove this phrase in TB mobile manualThis paragraph is very redundant ("if you know..."), we should improve it: https://tb-manual.torproject.org/mobile-tor/
>If you know that your connection is censored, you should select the settings icon. Tor Browser will take you throug...This paragraph is very redundant ("if you know..."), we should improve it: https://tb-manual.torproject.org/mobile-tor/
>If you know that your connection is censored, you should select the settings icon. Tor Browser will take you through a series of configuration options. The first screen will tell you about the status of the Tor Network and provide you the option to configure a Bridge ('Config Bridge'). If you know your connection is censored, or you have tried and failed to connect to the Tor network and no other solutions have worked, tap on 'Config Bridge'. You will then be taken to the Circumvention screen to configure a pluggable transport.