Project

General

Profile

Bug #12319

Suboptimal link in QR code for Mac installation assistant

Added by intrigeri 6 months ago. Updated about 2 months ago.

Status:
Resolved
Priority:
Normal
Assignee:
-
Category:
Installation
Target version:
Start date:
03/11/2017
Due date:
% Done:

0%

QA Check:
Feature Branch:
Type of work:
Website
Blueprint:
Easy:
Affected tool:
Installation Assistant

Description

The QR code on https://tails.boum.org/install/mac/usb/index.fr.html (3/7) has two problems:

  • it points to the English version of the page, confusing users who were reading the page in their preferred language
  • it points to the top of the page, while it should ensure continuity by pointing to the place where the user already arrived

This as shown up during a DIY, non-scientific usability testing I conducted a couple months ago.


Related issues

Blocks Tails - Feature #13423: Core work 2017Q3: Technical writing Confirmed 07/05/2017

History

#1 Updated by sajolida 6 months ago

  • Assignee set to sajolida

Assigning this to me to do some more tests. But someone else could take
it for me if they have solutions to propose.

#2 Updated by intrigeri 6 months ago

But someone else could take it for me if they have solutions to propose.

(I guess you mean patches, since the solutions seem quite obvious to me.)

#3 Updated by sajolida 6 months ago

  • Assignee changed from sajolida to intrigeri
  • QA Check set to Info Needed

Could you phrase it explicity then? Because it's not obvious to me.

#4 Updated by intrigeri 6 months ago

Could you phrase it explicity then? Because it's not obvious to me.

Sure, will do! (I guess I'll discover when writing it that it's not obvious, even if it still looks very much like it after re-reading this ticket, which is probably because I was present in person when these problems were noted in the first place, so it seems obvious to me what should have happened instead.)

Thanks for caring.

#5 Updated by intrigeri 6 months ago

  • Assignee changed from intrigeri to sajolida
  • QA Check changed from Info Needed to Dev Needed
  • it points to the English version of the page, confusing users who were reading the page in their preferred language

Apparently that's wrong, sorry: it points to an URL with no specific language indication, which means that language negotiation will happen between the browser and the web server. For some reason, the mobile browser the user was using during this test must have been configured to prefer English over French, or simply had broken language negotiation. Forget it!

  • it points to the top of the page, while it should ensure continuity by pointing to the place where the user already arrived

In other words: the QR code on https://tails.boum.org/install/mac/usb/index.fr.html currently points to https://tails.boum.org/install/mac/usb/. Instead, it should point to https://tails.boum.org/install/mac/usb/#switch-device.

One can use the qrcode-encode.sh script mentioned on https://tails.boum.org/contribute/how/documentation/ to update that QR code, and qrcode-decode.sh to verify their fix.

Phrased like this, do we agree a clear solution is documented?

#6 Updated by sajolida 6 months ago

#7 Updated by cbrownstein 4 months ago

  • Assignee changed from sajolida to intrigeri
  • QA Check changed from Dev Needed to Info Needed

If I'm understanding the issue correctly, the "Open these instructions from another device" step of installation instructions should provide a URL and QR code that takes the user directly back to this (the "Open these instructions...") step. Maybe this commit to the branch I've pushed better explains my line of thought:

https://github.com/cbrownstein/tails/commit/619ae6a56931d10ec48f36a65cda30beb6265ad5

If I'm understanding the issue correctly, please assign this ticket to me and I'll take care of it.

#8 Updated by intrigeri 4 months ago

  • Assignee changed from intrigeri to sajolida

If I'm understanding the issue correctly, the "Open these instructions from another device" step of installation instructions should provide a URL and QR code that takes the user directly back to this (the "Open these instructions...") step.

Yes :)

#9 Updated by cbrownstein 4 months ago

  • Status changed from Confirmed to In Progress
  • Assignee changed from sajolida to cbrownstein
  • QA Check deleted (Info Needed)

I'll handle this ticket unless, sajolida, you want to take care of it. :-)

#10 Updated by sajolida 4 months ago

Amazing, be my guest!

#11 Updated by sajolida 4 months ago

I quickly checked your commit and yes, that's the idea.

Now, we also need to update the QR codes themselves. We have some utilities to encode them. See https://tails.boum.org/contribute/how/documentation/#index2h1.

Apart from the QR codes, these URLs are meant to be typed manually as well. So I find important to keep them as short as possible and would say that every character counts. So we could probably try to find something shorter. Maybe https://tails.boum.org/install/win/usb#back or something else if you have another idea.

#12 Updated by cbrownstein 4 months ago

I updated the QR codes earlier but I lost my Internet connection and couldn't update the ticket.

https://github.com/cbrownstein/tails/commit/0c48e7b94c2d08a23c4fe6566854b91ce9ebf213

I'll look into ways to shorten the URLs.

#13 Updated by cbrownstein 4 months ago

  • Assignee changed from cbrownstein to sajolida
  • QA Check set to Ready for QA

I shortened the URLs and updated the QR codes.

#14 Updated by sajolida 3 months ago

  • Target version set to Tails_3.1

#15 Updated by cbrownstein 3 months ago

I shortened the URLs for real this time. :-)

(It appears that I didn't in commit 8ef7fcdd9bdd33b7a1c67ba2d1d37b9ccae153fc.)

I also unfuzzyied the translations.

#16 Updated by sajolida 3 months ago

#17 Updated by sajolida 3 months ago

#18 Updated by sajolida about 2 months ago

  • Status changed from In Progress to Resolved
  • Assignee deleted (sajolida)
  • QA Check deleted (Ready for QA)

Merging, thanks!

Also available in: Atom PDF