wiki:Website

Overview: main site redesign

Results (1 of 50)

1 2 3 4 5 6 7 8 9 10 11
Ticket Summary Owner Priority
#21222 Main ticket for website redesign project isabela Very High
Description

Website redesign main ticket introduction

This is a huge project the UX team is leading and it has a lot of steps involved on it. Our goal is for this project to be the base of something that can scale while we continue to iterate on it.

What problems are we trying to fix?

This project aims to fix many problems that goes beyond just a redesign thing, even though we are calling it 'website redesign'.

Yes, Tor Project website is not the best thing in the world and is a big problem that must be fixed. And this is a problem that we can't ignore anymore, is hurting many initiatives we have at Tor Project.

Our community is growing and this growth is part of the 'website problem'. A lot of information have been added to torproject.org over the years leading to what we have now. Is a good problem to have, but right now we must reorganize this information to better set ourselves to continue grow.

Here is a list of some problems easily recognizable with the current site:

  • Not localized
  • Too much information at the front page
  • Still hard to find information
  • Hard to add new information (ends up contributing to the mess) and we need to add more information because we are growing :) we have a lot to share
  • inconsistency with the design

And we could go on but the point of this doc is not to have a full description of all the problems we have but just an introduction to set the stage for explaining what we are thinking for a solution and the steps of its implementation.

How we solve it?

Our solution right now is to create new portals to better organize information and also at the same time keep torproject.org simple and easy for first comers to find their way around into what Tor is and how to get/use it.

So we will be building:

  • torproject.org - with 'new user' as our main audience for this portal [of course with easy way to navigate to the other portals:
  • dev.torproject.org - short explanation: "all things related to the development of free software projects of Tor Project"
  • community.torproject.org - short explanation: "a umbrella of things that are power by our community, or a portal to 'help people help Tor'.
  • support.torproject.org - user support website

Are we loosing press? FAQs? Donate page? The Blog? No :) the list above are the main entrance to all these things and more.

I invite you to read more about each of this portal and other work related to this initiative in the children tickets (and their children tickets) associated with this project. Is a big project and the information written here is a summary of the summary ;)

Why now?

Right now we are with fund and a team to carry this work. And we need to do this to enable many other great work at Tor to have infrastructure to support their project. We believe that these portals will help a lot of groups inside of Tor Project to better provide information about their work and therefore receive help to do so.

The short version of the process we will follow for each portal

#### process for each site will be:

  1. content architecture - map current content related to the portal and organize it
  1. whiteboard draw organization of the content into pages
  1. wireframe these pages
  1. create design for these pages [these include design reviews till we are happy with what we have]
  1. start organizing content for the pages (with the design already done we will be working with that)
  1. update high definition mockups with real content
  1. guerrilla user testing #1
  1. start coding the pages
  1. once content is finished we upload them on transifex for translation to start
  1. Once coding is done we can start QA by language (as translations gets complete)

10.[we could do another user test here too before launch if we want - or we can run one after lunch and continue iteration]

What we will use to build it?

Right now we are testing Lektor for the framework to use: https://trac.torproject.org/projects/tor/ticket/24275

We are also working on a project that will help us build the themes for these portals but also anyone else who would like to follow our style guidelines for their site.

We are creating a fork of bootstrap and changing its css based on our guidelines, we plan to use it to build the front end of the portals. You can follow this project here (and it's children tickets):

[ need to add ticket ]

Some portals like 'support' need a search tool as well. For that we are looking at:

[ need to add a ticket ]

Are we planing to test things?

Yes, not only our framework but everything! We hope to do as many research and test we can, it will all depend on our bandwidth and resources. Since we have been working on building this 'testing' and 'research' steps into our processes we already have some stuff in place that can help us carry those on. We hope to continue to add more resources in this front to be able to do even more of those in the future!

This project is actually the first year of a 3 years project where we hope to build this user feedback / testing process and have it happening in large scale for all the projects we are working on.

What about translation?

We will localize first:

  • torproject.org
  • support.torproject.org

The languages we will support are our tier1 languages : https://storm.torproject.org/shared/o7Rh2S9bsMNN7Eh7C9cKaqxR371pR1AmpRxbu--nC34

  1. English - EN
  2. Farsi - FA
  3. Spanish - ES
  4. Russian - RU
  5. Simplified Chinese - zh-CN
  6. Portuguese - PT-BR
  7. French - FR
  8. German - DE
  9. Korean - KO
  10. Turkish - TR
  11. Italian - IT
  12. Arabic - AR

Translation will be done using Transifex community, thousands of people who have already been translating other Tor things.

We will add a step for Localization Review of the translated sites with a native speaker of each language. So we can have a review in context since as many other crowdsourcing translation tools, translation within context is something they miss. But they do have other features, such as translation memory and vocabulary features that helps a lot on making sure of the translation quality across so many pages and product UIs.

So we will stick with the good practices of using a good tool like Transifex to do the translation and incorporate a review in context step with native speakers. Hopefully we will have volunteers to help us out with all those tier 1 languages.

What have we done

*this part is not done yet* The story of Tor Project website is long! But to cut it short we will talk from 2015 - now (EOY 2017)

This work will incorporate work from past efforts. We did some work on the support page before this site-wide effort.

1 2 3 4 5 6 7 8 9 10 11

Website team communication channels

Mailing list:

IRC:

  • #tor-www on OFTC (irc.oftc.net)

Tickets

Ticket Summary Owner Component Milestone
#11569 Consider making donations part of the download process Webpages/Website WebsiteV3
Description

The re-designed download-easy page (https://www.torproject.org/download/download-easy.html.en) has resulted in a 2x increase in monthly donations since deployment. Some thoughts to consider:

  1. move the donations button closer to the download button.
  2. Rework the page so the donations button is first, with a nice reason why donations are needed, but clearly state downloads are still free, and click the download button to skip a donation process
  3. Change the page flow so that downloads go to a donation request page first, and then after 10 seconds of no action, redirect to the download-easy page.
#27132 find Tor-friendly payment site Webpages/Website WebsiteV3
Description

From parent #11569

it seems the clear next step is to find one not-totally-unusable payment site that doesn't hate Tor users, and drive all the traffic there.

Milestones

Results (1 - 15 of 50)

1 2 3 4
Ticket Summary Owner Priority
#21222 Main ticket for website redesign project isabela Very High
#25218 Update screenshots to use obfs4 bridges (instead of obfs3) jaruga High
#3893 Verifying-signatures needs some work arma Medium
#10990 Shrink the FAQ mttp Medium
#13665 Update the obfsbridge setup instructions on the website cypherpunks Medium
#13843 Add a faq entry for "You should change path selection to avoid entering and exiting from the same country." cypherpunks Medium
#14569 Download-Easy page don't make other languages obvious saint Medium
#19683 Add flag to allow building website without tor docs arthuredelstein Medium
#21519 Tor Project FAQ hiro Medium
#21808 show Windows `gpg --verify` command on one line hiro Medium
#22265 write high-level overview of bootstrap process catalyst Medium
#22402 Usablity and accessiblity improvement on the Tor assistant page linda Medium
#22405 Fix onion links for downloading Tor Browser hiro Medium
#22611 Make TB uninstall instructions more detailed in FAQ linda Medium
#22637 Find a more maintainable approach for the signing-keys page hiro Medium
1 2 3 4

Results (1 - 15 of 21)

1 2
Ticket Summary Owner Priority
#14686 Consolidate or de-emphasize our many download pages traumschule High
#17669 Old links to outdated versions of Tor Browser should redirect to a page with the latest version of Tor Browser hiro High
#5489 Write up a "how to report bugs and security issues, and what happens then" post or FAQ nickm Medium
#11569 Consider making donations part of the download process Medium
#13134 Figure out access rights to new dists.torproject.org tpa Medium
#16406 "Tor" is not listed as a project on torproject.org cypherpunks Medium
#16546 Should we move anonbib to the Tor website? cypherpunks Medium
#16548 Change the HS nomenclature from hidden to onion cypherpunks Medium
#16576 Add a 'community projects' list (separate page?) to the website mrphs Medium
#17393 Make the various javascript on Tor sites be LibreJS-compatible? cypherpunks Medium
#17413 Usability of MacOS installation process cypherpunks Medium
#18243 Website redesign - Phase 1 isabela Medium
#18245 Collect different mocks for new site isabela Medium
#19930 web site menu needlessly jumps around cypherpunks Medium
#21178 torproject.org submenus and page structures behave inconsistently hiro Medium
1 2

All website tickets

See all tickets related to the website, sorted by status.

Results (1 - 15 of 85)

1 2 3 4 5 6
Ticket Summary Owner Component Milestone
#3893 Verifying-signatures needs some work arma Webpages/Website website redesign
Description

https://www.torproject.org/docs/verifying-signatures.html.en is ridiculously complicated and stuffed with tons of irrelevant information.

We should break it into 2 pages. The list of keys that signs sub-components and/or email should be on a completely separate page. The only keys on this page should be those that actually sign user-facing packages: TBB and (maybe) the vidalia expert bundles.

The page should walk the user through verifying a signature of a specific package for each platform. The page should focus on only one key and only one package. This package should probably be TBB.

Also, much of the material on this page is out of date. For example, the Mac utilities are completely different now, are hosted at a new URL, and now have a GUI that handles the key import process (but sadly not package signature verification). They do at least put the gpg binary into the system path, so you no longer have to grovel through /Applications in order to find it.

#5489 Write up a "how to report bugs and security issues, and what happens then" post or FAQ nickm Webpages/Website WebsiteV3
Description

We should summarize our current security process on a blog post, FAQ entry, or on the contact page. This hasn't gotten enough attention, since everybody's so busy, but

We should at the minimum let people know:

  • What issues to do this way and what should just go on the bugtracker. And why.
  • How to report bugs in general.
  • What to expect if you report a security issue.
  • Our current issue evaluation and response process, the history thereof.

This should be someplace pretty easy to find. A longer blog post and a shorter faq or contact entry seems smart to me.

#10990 Shrink the FAQ mttp Webpages/Website website redesign
Description

The wiki FAQ entries have been transferred to the main website FAQ. Now the page needs to be improved.

  • Add all subheads to the top of the FAQ for easier navigation.
  • Delete entries that are outdated, no longer relevant, or not frequently asked on the help desk.
  • Consolidate Tor Browser and Tor Browser 3 subsections.
  • Move sha256sum verification to the signature verification section.
  • Migrate information on setting up a relay to a dedicated page.
  • Migrate Abuse questions to the Abuse faq and kill the subsection.
  • Dedicated page for Alternate designs we don't do yet.
  • Kill Compilation and installation subsection.
  • Consolidate questions that duplicate answers.
#11289 FAQ entry for where Tor's data directory is mttp Webpages/Website WebsiteV3
Description

I just took a peek in our faqs to see if there was a "Where is my data directory?" entry I could link to. We don't seem to have one, and tor's man page says "Store working data in DIR (Default: @LOCALSTATEDIR@/lib/tor)". I have no clue what that macro expands to, nor would I expect users to. :)

If we can't clarify the manual page then this seems like something we should include in our FAQ since it in turn defines the path of our authentication cookie among other things.

#11569 Consider making donations part of the download process Webpages/Website WebsiteV3
Description

The re-designed download-easy page (https://www.torproject.org/download/download-easy.html.en) has resulted in a 2x increase in monthly donations since deployment. Some thoughts to consider:

  1. move the donations button closer to the download button.
  2. Rework the page so the donations button is first, with a nice reason why donations are needed, but clearly state downloads are still free, and click the download button to skip a donation process
  3. Change the page flow so that downloads go to a donation request page first, and then after 10 seconds of no action, redirect to the download-easy page.
#13665 Update the obfsbridge setup instructions on the website cypherpunks Webpages/Website website redesign
Description

https://www.torproject.org/projects/obfsproxy-debian-instructions.html.en#instructions

As sysrqb noted, the official obfsbridge setup instructions are actually obfsproxy setup instructions which only support obfs3. The instructions should be updated to also include obfs4 which is the future PT. Then, we should also include instructions for FTE.

Furthermore, the page is missing ExtORPort auto from the sample torrc. Should we add it there? If yes, we need to make sure that all those people will have tor-0.2.5.x installed.

I hope this is not a duplicate ticket.

#13843 Add a faq entry for "You should change path selection to avoid entering and exiting from the same country." cypherpunks Webpages/Website website redesign
Description

https://blog.torproject.org/blog/tor-browser-45-alpha-1-released#comment-79839 makes me realize that this is an ongoing question and I expect it will come up more with the new Torbutton interface for visualizing your paths.

What should users actually do with the information that, for example, their first hop and last hop are both in the US?

If we have an actual recommendation, we should change Tor to do that thing automatically.

I think the current situation is that there are many attacks and adversaries that Tor is trying to defend against at once, and constraining paths has surprising trickle-down effects on the other attacks (e.g. if I see where you exit then I know where you *didn't* enter, thus reducing your entropy, sometimes by a surprising amount depending on what path constraints we pick).

So the current advice amounts to "don't mess with it, you'll probably screw it up, we don't understand it very well either". We should figure out a way to concisely give people all the intuition that we have, so they can make good decisions.

#14569 Download-Easy page don't make other languages obvious saint Webpages/Website website redesign
Description

dcf and mrphs brought up that the language select section is really small when not using javascript -- most people probably scroll right past it. In tutorials, people are using English-language screenshots, which is kind of interesting.

Proposed fix is to increase the font size to 1.1em. Long-term, it would be great to remove all javascript from these pages.

#14686 Consolidate or de-emphasize our many download pages traumschule Webpages/Website WebsiteV3
Description

During the UX Sprint, several of the users found alternate download pages other than download-easy, and became confused. If you search for Tor, download Tor, or Tor Browser, you get one of the following links:

https://www.torproject.org/download/download https://www.torproject.org/projects/torbrowser.html.en https://www.torproject.org/download/download-easy.html

Each of these has a different flow for downloading Tor Browser, and all but download-easy caused users to stop and become confused. I personally think https://www.torproject.org/download/download should simply redirect to download-easy, and the https://www.torproject.org/projects/torbrowser.html.en page should remove the matrix and either behave like download-easy, or its download button should take the user to download-easy.

We will still need some place to put installation instructions, and the alpha downloads, but those should be broken off into different pages that replace the outdated mess in https://www.torproject.org/docs/documentation.html.en.

#16406 "Tor" is not listed as a project on torproject.org cypherpunks Webpages/Website WebsiteV3
Description

It would be nice to list "Tor" as the first project on torproject.org: on the main page, under "Our Projects" and on https://www.torproject.org/projects/projects.html.en

#16546 Should we move anonbib to the Tor website? cypherpunks Webpages/Website WebsiteV3
Description

Right now, anonbib exists under freehaven auspices, and is not maintained by Tor.

"Not maintained" being the operative word.

Should we move it to a torproject url and try to pretty it up a bit?

#16548 Change the HS nomenclature from hidden to onion cypherpunks Webpages/Website WebsiteV3
Description

As discussed during the anonymous services meeting, we should change (or discuss changing) the nomenclature on the website to reflect Syverson's Genuine Onion paper.

Please do not make the mistake of grepping for Hidden and replacing it with Onion.

#16576 Add a 'community projects' list (separate page?) to the website mrphs Webpages/Website WebsiteV3
Description

We have a growing list of community projects -- projects that use Tor but have their own community / entity / something as well.

I'm thinking Ricochet, SecureDrop, Globaleaks, Whonix, Onion Browser, ChatSecure, HTTPS Everywhere, Onionshare, pond, tor-ramdisk, Cupcake, Ahmia.

In the future we might list OnionBalance, OnionTip, Roster.

Since there are quite a few, we might list some at the top as 'highlighted community projects', and then the rest down below that.

#17393 Make the various javascript on Tor sites be LibreJS-compatible? cypherpunks Webpages/Website WebsiteV3
Description

On reading https://www.gnu.org/software/repo-criteria.html (as pointed out on tor-talk), I came across "B0": "All code sent to the user's browser must be free software and labeled for LibreJS or other suitable free automatic license analyzer".

I don't know anything about the politics behind libre JS or the like, but I know some of the Tor sites use JavaScript, and I also know we're not meaning to keep any of it non-free.

Is there some enthusiastic free software zealot out there who wants to inventory the javascript used on various Tor sites, and move us closer to labeling it all as free?

#17413 Usability of MacOS installation process cypherpunks Webpages/Website WebsiteV3
Description

Usability of MacOS installation process

Consequence: User is unable to verify package signature

Steps to reproduce:

  1. Download Tor browser
  1. Go to https://www.torproject.org/docs/verifying-signatures.html.en for instructions.
  1. Read the block of text for MacOS and Linux.
  1. Follow the link at the bottom of that section to:

https://www.gnupg.org/documentation/

  1. Struggle with the information on that page.
  1. Try to go to the SourceForge link there for GPG Mac download.

uBlock Origin blockade: uBlock Origin has prevented the following page from loading:http://macgpg.sourceforge.net/

Because of the following filter

sourceforge.net$other

Found in: uBlock filters – Badware risks

  1. Give up.

What should have happened:

Follow the GPGTools link at the top of the Tor page's Mac/Linux instruction block. https://www.torproject.org/docs/verifying-signatures.html.en


Suggested fixes:

  • Divide the MacOS instructions from the Linux instructions.
  • Add numbers to the procedures... something like this, for the MacOS:
  1. Download Tor Browser and save the signature.asc to your Desktop.
  2. Download and install GPGTools.
  3. Open a Terminal window (Terminal is in /Applications/Utilities or find it with search)
  4. Paste the following into the terminal: [... ...]

...adding links appropriately in the procedure

  • Use link colors to help people visually scan through the pages. Take advantage of the human tendency to skim over text and just read the bold, colored stuff:

-Use a color with better contrast against black (the green is wonderful but too dark for good contrast) -Include more keywords in links

  • Related installation issue that probably belongs somewhere else:

Opening the DMG and installing the Tor Browser: The application file shows a file modification date of Dec 31, 1999, so it's difficult to know whether the downloaded one is newer than one I have already. No version number is in the file name. Get Info (cmd-I) (which not every Mac user knows about) does show a version number, and it also shows the file has a creation date of Dec 31, 2000, which is before the mod date. The weird dates might cause version control issues but are also likely to worry people who see them.

1 2 3 4 5 6

How to contribute ideas

This wiki should be seen as a record of concrete proposals. As such, here is a loose procedure to follow if you would like to suggest new ideas:

  1. Write a proposal on the wiki
  2. Start a discussion on the www-team with a copy of the proposal
  3. Build a consensus and refine the wiki
  4. Repeat!
  5. Implement

Engine

The current website is powered by WML. Switching to a more recent engine supporting lighter syntax (like Markdown) is probably worthwhile.

Technical requirements

  • Generate static web pages that can work offline as well. That means self-contained and zero 3rd party requests. No mandatory client-side JavaScript either.
  • Content should be kept in Git.
  • Support for the “Don't Repeat Yourself” principle, e.g. the latest version of the Tor Browser Bundle needs to be kept at a single place but used at different places in the website.
  • Support translations. A changes in a single paragraph should be easily to propagate to translators and to then to translations.

Candidates

The following projects look like potential candidates:

Pelican

Pelican is a static site generator, written in Python. Documentation

Jekyll

Jekyll is a simple, blog-aware, static site generator, written in Ruby. Website

Middleman

Middleman is a static site generator using all the shortcuts and tools in modern web development, written in Ruby. Website

Nikola

Nikola is a Static Site and Blog Generator. Website

How to build the current website

Some commands than can be used on a Debian Wheezy system to build the current website:

    apt install wml
    apt install --no-install-recommends asciidoc
    git clone https://git.torproject.org/tor.git
    git clone https://git.torproject.org/project/web/webwml
    echo "export TORGIT=$(pwd)/tor/.git" > webwml/Makefile.local
    cd webwml/
    make

This should only be required if structural changes are necessary, typically you should push a branch with changes somewhere and ask for a pull by opening a ticket in the website component here.

Notes

Some notes from a discussion that happened during 30C3 gathering ideas on how to structure the website.

Roadmap

The following was brainstormed at the Berlin dev. meeting in September 2015.

Sebastian will be the main gatekeeper of the website. Changes should be proposed using tickets on Trac with the “website” component. Ideally the ticket should contain a pull request or a patch. For people who are not able to modify the code or don't want to, we have a team of people willing to act as integrator.

A “staging” website will be built automatically. When a substantial change is merged, a call for review should be sent to the www-team mailing list. A clear deadline for reviews should be announced in the call. Once that deadline is past and either there was not problems or they have been solved, the result is pushed in production.

For language changes, we might not want to push changes in production right away but rather gives a heads-up to translators. This would not be a blocker, but just a couple of days to give the chance to have more translations in sync.

To make a language available, the 85% of the website needs to be translated and the language should have a designated reviewer. That person would send pull requests once they have vouched a translation as correct. They would also be the point of contact when bugs are reported for a given translation.

Contact

  • Sebastian
  • Isabela

Proposals

Proposed new information architecture

  • Understand
    • For: Everyone and journalists
  • Use
    • Howto
  • Research
    • Whitepapers
    • Papers
    • Tech Docs
    • Anonweb
  • Contribute
    • Finance
    • Outreach Materials Ideas Stuff
  • Subproject - List
  • FAQ
  • Blog
    • Localized blog? E.g. fa-blog.torproject.org contains information specific to a given location. Do the same for de, mx, or other places?
  • Press

Personas

The Student

The Student has recently heard about Tor and would like to discover more about it. Particularly he has heard from a friend that it could be used to protect his web browsing whilst using the university campus public wifi.

The Journalist

The Journalist has been writing about online privacy for the past year and would like to write a feature about Tor. Although she has previously experimented with Tor's browser bundle she would like further information of how the Tor infrastructure functions and the technical details behind how it enables online anonymity.

The Researcher

The Researcher works for a think tank. She has been a user of Tor since December 2011 and is a strong proponent for an open web. Since finding out about Tor, Stephanie has become involved in the Tor community contributing fixes and features to the Tor code base and engaging with other Tor contributers using the mailing lists and IRC.

The Donor

The Donor has read about Tor in the local newspaper and would very much like to make a donation.

The Engineer

The Engineer has been a Tor Relay Operator for a little over a year and has encouraged two of his colleagues to do the same.

The Activist

The Activist would like to comment anonymously on the Internet and not link her personal accounts to her activism work. She would like to use Tor to achieve this.

The Dissident

The Dissident lives under an oppressive regime which heavily filters the internet. He is very aware of the consequences to himself and his family if he is discovered. He is hesitant to use Tor without knowledge of how it works and what its limitations are (ie. an adversary that monitors Internet connections).

Technical Requirements

  • Debian native citizen
  • Static Site Generator
  • Easy to use for whole staff
  • Internationalization

Useful base concepts

  • Direct each user quickly to the right part
  • If graphic redesign, think about the whole project, general 'CI'
  • Communicate basic concepts with communication department
  • Primary target: never deliver software without education

Discussions

User Education

  • Educate before download
  • Educate on browser startup
Last modified 7 days ago Last modified on Aug 10, 2018, 12:45:16 AM