Bug #12319: Suboptimal link in QR code for Mac installation assistant

Bug #12319

Suboptimal link in QR code for Mac installation assistant

Added by intrigeri 2017-03-11 12:54:18 . Updated 2017-07-31 15:50:38 .

Status:

Resolved

Priority:

Normal

Assignee:

Category:

Installation

Target version:

Tails_3.1

Start date:

2017-03-11

Due date:

% Done:

Feature Branch:

Type of work:

Website

Blueprint:

Starter:

Affected tool:

Installation Assistant

Deliverable for:

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.

Subtasks

Related issues

Blocks Tails - ~~Feature #13423~~: Core work 2017Q3: Technical writing

Resolved

2017-07-05

History

#1 Updated by sajolida 2017-03-13 16:15:25

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 2017-03-13 16:26:25

> 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 2017-03-13 19:54:00

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 2017-03-13 21:48:29

> 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 2017-03-14 05:58:58

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 2017-04-07 15:15:33

blocks ~~Feature #12432~~: Technical writing core work 2017Q2 added

#7 Updated by cbrownstein 2017-05-22 01:04:07

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 2017-05-22 06:09:02

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 2017-05-22 07:51:25

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 2017-05-22 21:00:45

Amazing, be my guest!

#11 Updated by sajolida 2017-05-22 21:10:08

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.