Join Our Second Documentation Hackathon March 22-30

by ggus | March 17, 2020

Documentation is extremely valuable to the health of open source software projects, but it is often overlooked. We are a small team at Tor, and as a nonprofit organization with a big mission, we rely on volunteer contributions around the world to keep up with an ever-changing internet freedom landscape with the appropriate tools to navigate it. Keeping Tor's documentation up-to-date, organized, and accessible is a way to potentially help millions of people access a private, secure, and uncensored internet by using our tools
Between 22 and 30 March, the Tor Project will host the second edition of our user documentation hackathon, the DocsHackathon. The DocsHackathon is a totally remote and online event. 
If you've never volunteered with us before, this is an opportunity for you to become involved in the community, get closer to our work, and make meaningful contributions. During our first DocsHackathon last September, we had 70 registrations, 8 contributors, and over 70 pull requests to the support portal, Tor Browser manual, our main website, and other repositories. If you helped out last year, we hope you can join us again or help spread the word. Once the DocsHackathon is completed, we'll reward the top 3 contributors with official Tor swag.
So if you're a copywriter, front-end dev, tester, or content reviewer, we'd appreciate your help improving our documentation, updating our support portal, and ensuring their relevancy. Don't feel like any of these apply to you but still want to help out? Chat with us on IRC (#tor-www - or the community team mailing list to join us and find out where you could add value. 
To participate in the DocsHackathon:
  1. Register to get access to create and comment on issues in our Gitlab.
  2. Join the Community Team mailing list.
  3. Take a look at all of the tickets marked with the "DocsHackathon" keyword on Trac and Gitlab.
  4. If you have a documentation issue that is not currently reflected in Trac, create it, tag it, and let one of us know on IRC channel #tor-www.
  5. Choose a ticket and start working on it! You can submit Pull Requests on our GitHub or from your own git instance.
  6. This isn't a requirement, but: If you talk about the the hackathon on social media, we're using #DocsHackathon.
A contribution will be counted when your PR or merge request is merged to the master branch of the relevant repository. The awards to contributors will be announced after all the merges are done.
For more details on how you can contribute, check out our DocsHackathon wiki.
We are a small nonprofit with a big mission, and we sincerely appreciate your help getting our documentation up to speed. We look forward to working with you soon.


Please note that the comment area below has been archived.

The Tor Project is transissioning from our old bug tracker to our own GitLab instance, At the moment, this instance is only used for a few teams to manage project issues. When we finally migrate all the issues from Trac, it will be open to the public. All the issues are open and can be read anonymously. Also a reporter doesn't need JavaScript enabled to read or open new issues.

Also note that we don't log IPs in our services.

We also offer many other ways to report a bug or give feedback that doesn't involve JavaScript.

There are many ways to contribute on Git anonymously. If you're a beginner and want to help on this documentation hackathon, the best way is to ask an account in the registration form and use Tor Browser and the web interface to submit your Pull Requests. You can use any email you want. Or a temporary email that you can discard as soon as you receive and set your password. If you want to help on more advanced issues, that needs to compile the CMS, we recommend you to use Tails with persistence, so even if you miss something, it won't reveal your real username or IP address.

April 01, 2020


If TOR is a "private browser" why when I search using Startpage does it show results from a search I did from 8 years ago on Ebay? Is this a TOR or Startpage issue?? This is insane.

April 01, 2020


Hey guys I was wondering if you guys could create a way for windows users to easily setup obsf4 bridge to help people in countries that face heavy censorship. I say this because people with the technical know how to be a relay operator are a minority in the world and so are people using Linux and I thought that in order to grow the network the majority should be able to contribute. Most systems as of today use of Windows around the world. I personally run Windows 10 and reside in America a country free of censorship of any kind as per my knowledge though there is considerable tracking but it is a great place economically and Internet here is generally fast especially if you use spectrum and I reside in OP Kansas. I am just a 16 year old kid and I would like to help as I used Tor services to fulfill a personal task of the utmost importance but I can't because of the factors stated above. Please, I really would like to contribute.

If you want to help censored users, the easiest is to install the snowflake browser extension:

Snowflake is not yet included in stable Tor Browser releases (only Linux and macOS alphas), but we are working on it. The extension however (which is for helping censored users) should work in Chrome and Firefox on any OS.