[tor-project] Updating the Tor Browser user manual

Isabela isabela at riseup.net
Tue Mar 8 15:30:10 UTC 2016

Hi Colin,
this is great stuff, so happy to see this plan coming together.

I want to add that once the documentation is back online and as we move
with the website redesign plan, we should make sure to have on our 'wish
list' how we can improve the usability of this documentation.

I remember when sponsorO was ending, we were talking about ways to
display documentations to the user that can be smarter about popular
articles and easier to navegate / find articles, like
support.twitter.com does.

thanks for working on this!

On 03/08/2016 04:32 AM, Colin Childs wrote:
> Hi everyone,
> I hope you all had a great time in Valencia! As I mentioned in my
> previous status report, here is my current plan for updating the Tor
> Browser user manual. The idea behind doing this, is that a large portion
> of the tickets that come into the help-desk could be directly resolved
> by this document, if it were maintained and available in
> a way that users could easily access.  I believe spending the time to
> finish up the manual and make it available would be more helpful to the
> help-desk, and the users than answering the hundreds of individual
> questions posed by the users that are already answered in this manual.
> When the help-desk initially started, the "short user manual" existed,
> which was where the majority of answers for users came from. This was
> extremely handy, as we were able to link them that document and the
> majority of users could work through it themselves, saving the help-desk
> for when they ran into issues. I'd like it if this could be the state of
> affairs again, as it made the lives of help-desk staff a lot easier at
> the time.
> Please let me know what you think of the plan below:
> - Update certain outdated screenshots
> - Do a complete pass of content review, and update / clean up any
> outdated or missing sections
> - Write out an update plan for the manual, as described in
> https://gitweb.torproject.org/tor-browser/user-manual.git/tree/TODO
> - Find a home for the document on torproject.org, hopefully in a
> mirrored location
> - Contact trusted translators to work on localizing the user manual, or
> updating the parts that were already localized but updated.
> - Upload manual to Transifex, and let translators begin working on the
> strings.
> - Discuss ways the manual could be added to the Tor Browser (Only after
> it exists on the website)
> - Begin pulling in new translations from language teams with trusted
> reviewers, and are at 100% completion
> Thanks for looking this over!
> _______________________________________________
> tor-project mailing list
> tor-project at lists.torproject.org
> https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-project

PM at TorProject.org
gpg fingerprint = 8F2A F9B6 D4A1 4D03 FDF1  B298 3224 4994 1506 4C7B

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.torproject.org/pipermail/tor-project/attachments/20160308/6979e667/attachment.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 819 bytes
Desc: OpenPGP digital signature
URL: <http://lists.torproject.org/pipermail/tor-project/attachments/20160308/6979e667/attachment.sig>

More information about the tor-project mailing list