freedomofpress / securedrop.org

Code for the SecureDrop project website
https://securedrop.org
GNU Affero General Public License v3.0
40 stars 8 forks source link

Update sd.org site content to include internationalization #756

Open ninavizz opened 5 years ago

ninavizz commented 5 years ago

Problem: There is no clearly discoverable content on the website that makes product availability in other languages, evident. Because we want places in more vulnerable and non-English speaking locales around the world to install SecureDrop, this is kind of a drag.

Proposed Solution: Below content edits and additions. Edits also address a few other concerns that my feelings will not at all be hurt, should others object. :) Clarity, information discovery, usability, and improved brand positioning are goals with copy edits.

Recommended implementation:


Objectives with edits below

Homepage

Existing SecureDrop is an open source whistleblower submission system that media organizations can install to securely accept documents from anonymous sources. It was originally coded by the late Aaron Swartz and is now managed by Freedom of the Press Foundation.

Recommended SecureDrop is an open source whistleblower platform that organizations can use to securely communicate with anonymous sources sharing sensitive information. It was originally created by the late Aaron Swartz, and is now managed by Freedom of the Press Foundation and available in <#> languages.

Overview Page:

Existing Why leading news organizations use SecureDrop to communicate with sources

SecureDrop is an open source whistleblower submission system news organizations can install to safely and anonymously receive documents and tips from sources. It is used at over 50 news organizations worldwide, including The New York Times, The Washington Post, ProPublica, The New Yorker, and The Intercept. If you would like to quickly get a feel for the user experience, you can try the demonstration instance on the open web. You can read more about the advantages of the SecureDrop architecture below:

Proposed Why leading news and advocacy groups use SecureDrop for people to safely and anonymously communicate with them

SecureDrop is an open source, self-hosted document sharing and communication platform created to provide anonymity and best-in-breed security to organizations bringing public attention to abuses of power, and to the whistleblowers that make courageous journalism possible. If you are one such individual, find an organization with a SecureDrop to reach-out to. This website does not accept submissions.

SecureDrop is available in <#> languages and is used by over <#> organizations worldwide including The New York Times, Greenpeace, The Washington Post, Forbes, FaithLeaks, Center for Public Integrity, Al Jazeera, and more.

Take a look at one of our product demos, and learn more about SecureDrop, below: 5 existing illustrated blurbs 6th Illustrated blurb: image of 3-5 multi-cultured/gendered people with an accompanying text to point to localisation page

FAQ page

Problem: @redshiftzero FAQ pages are done best, when simple questions are authored with simple answers, that in conclusion point to deeper pages in documentation (or a product marketing page) to get more info—unless the answer is as simple as "yes or no and here's why." None of those pages currently exist for SD translation things... so quickie FAQ content that is helpful (vs more confusing) shd not imho be endeavored w/o a few quickie adds to findthedocs. Forums are good for contributors, but frustrating to be pointed to for when looking for concrete answers.

FWIW, today it's really hard to find any concrete resources on translations availability. I only found the LocalizationLab AMA because I know about LL and googled "Localization Lab SecureDrop".

  1. Add a section in the documentation that clearly speaks to which languages are available in the current release, and link-outs to access each translation's installation package. Yes, that's a lot of fussy work to maintain with each release; the alternative, would be to just always put links to all available languages, on each release's "download" GitHub page. I'm also assuming there's a different installer for each language, and maybe that's not the case. If that's not the case, then that should be spoken to in both the installation guide and in an "available languages" section of readthedocs. More detailed instructions don't seem to me to be necessary—just a simple section with simple links, that answers the question "How do I install 'x' in 'y' language" seems like it'd suffice for now.

  2. Because there is no uniform landing page template (nudge, nudge—we shd create this and test the content for comprehension, leaving this up to news orgs is a burden to them and creates usability probs!) FPF is not able to offer use-instructions in other languages—which tbh, seems like it'd be desired by newsrooms, almost more than a translated UI. It's been my experience that instructional content is often translated before webapp UI.

Section: About SecureDrop Q: Is SecureDrop available in languages other than English? A: Yes! SecureDrop has been translated into Arabic, Spanish, Chinese, and many other languages. Check the release notes(link-to main release notes page) for the latest release, to see what languages are currently available.

Section: Getting SecureDrop at your organization Q: What languages is SecureDrop available in? A: SecureDrop is available for journalist, admin, and source users, in several languages including Arabic, Spanish, and Chinese. To see a complete list and how to access each installation package check the release notes(link-to main release notes page) for information about the latest release.

Localisation page

(content tbd)

eloquence commented 5 years ago

For the "Features" section:

icons

We'll need an icon to represent availability in multiple languages. This icon will need to be under a permissive license (e.g., MIT) or in the public domain so we can distribute it with the soon-to-be-open-sourced website codebase (where this issue should ultimately be migrated, but we can keep it here for now for community visibility).

@ninavizz has offered to design or select an icon for this consistent with her recommendation above ("image of 3-5 multi-cultured/gendered people"); @harrislapiroff please jump in if you have any preferences here or want to take a stab at it yourself. :)

I've confirmed that we can add/remove topics to this section without dev changes.

eloquence commented 5 years ago

Per discussion with @ninavizz & team, I updated the intro language from:

SecureDrop is an open source whistleblower submission system that media organizations can install to securely accept documents from anonymous sources. It was originally coded by the late Aaron Swartz and is now managed by Freedom of the Press Foundation.

To:

SecureDrop is an open source whistleblower submission system that media organizations and NGOs can install to securely accept documents from anonymous sources. It was originally created by the late Aaron Swartz and is now managed by Freedom of the Press Foundation. SecureDrop is available in 15 languages.

(Further suggested tweaks welcome, especially if they bring the length back down a bit!)

ninavizz commented 5 years ago

Will be able to give attention to this after the 31st. Bogged down with Workstation and grant-y things, until then. 💃

harrislapiroff commented 5 years ago

The text sounds great. Totally happy for @ninavizz to take a swing at the icon. If it helps the icons we have were all modifications from one of the countless mostly indistinguishable flat icon sets on Creative Market, though I don't recall which one.

eloquence commented 5 years ago

Chatting with Harris a bit, because these icons are not part of the repository but uploaded only to the production version of the site, licensing commercial icons doesn't create problems for open sourcing the website repo.

So @ninavizz if you have a recommendation for a commercial icon we can use for this purpose, you don't need to spend design cycles on it; we'll just need reasonable licensing terms for our own use. But of course if you prefer to create your own icon that's also fine. :)

eloquence commented 3 years ago

(Still some remaining potential improvements here, so transferred over to securedrop.org repo.)