Feature #10104

Assistant: Refine Windows scenario (tchou's plate)

Added by sajolida 2015-08-27 07:16:12 . Updated 2015-09-28 10:07:05 .

Status:
Resolved
Priority:
Elevated
Assignee:
Category:
Installation
Target version:
Start date:
2015-08-27
Due date:
% Done:

100%

Feature Branch:
Type of work:
End-user documentation
Blueprint:

Starter:
Affected tool:
Installation Assistant
Deliverable for:

Description

We have 40 things to change as a result from Feature #10047, so no, we’re not going to track each one in a separate Redmine ticket with broken parenthood. This is tchou’s plate. The numbers correspond to the lines in /code/attachments/download/917/windows-testing-issues.fods.

  • 31. Propose phrasing and layout for reward messages after each step.
  • 60. Check with intrigeri if we could prevent the progress bar from getting stuck at 95% => Bug #10114
  • 66. Consider adding a splash screen before Persistence Assistant starts => Feature #10115
  • 65. Think about what to say in a goodbye message.

Files


Subtasks


History

#1 Updated by sajolida 2015-08-27 07:16:24

#2 Updated by tchou 2015-08-28 07:26:12

  • Description updated

#3 Updated by tchou 2015-08-28 07:30:42

  • Description updated

#4 Updated by sajolida 2015-09-03 08:28:37

  • blocks Feature #9444: Assistant: Explain how to verify that the source USB is up-to-date added

#5 Updated by sajolida 2015-09-09 04:53:46

While working on 31, you could maybe integrate these in the state images from the infography, see Feature #9206 and web/9206-steps-prototype.

#6 Updated by tchou 2015-09-18 06:16:30

  • Description updated

#7 Updated by tchou 2015-09-18 06:28:22

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

For the steps, I imagine to have on each section’s change all the state images on the same line (I could not see your work on steps) with a tiny text.

- Past image with a lot of opacity.

- Current section highlighted
- Futur section visibles with tiny opacity

This voice (warmer, less technical) is the same than in the welcome screen (same typo, size…).

Here is a first draft (as you know I prefer to do it here in redmine rather than in git).

31.

after the download and verify section:
    Congrats, the ISO image as been downloaded and verified.
    Now, it's time to put this ISO on a first USB stick to do a temporary Tails.


after the install a temporary Tails section:
    Cool, now you have your temporary Tails on your first USB stick.
    You will have to reboot your computer on this stick.
    It can be kind of tricky. Gook luck !


after the restart on the temporary Tails section:
    The hardest as been done. Now take your second USB stick.
    It's time to install our final Tails.


after the install the final Tails section:
    Yeh, you have a Tails :-)
    If you want to save documents or have some extra features on an encrypted storage (on the same USB stick), follow the next step.
    Otherwise, have a look to our [last recommandations].



65.

after the create an encrypted storage (goodbye message):
    You have a working Tails, congrats !
    We hope that you will enjoy using it :-)

    Do updates as fast as you can, your security depends on it.
    Remember that Tails does not protect from everything.
    Have a look to the [warning_section] and some [usefull_guides_on_security]

    If you have any problems, use your bug report app on the Tails desktop or visit our [help_pages].
    Time to run Tails!

60 and 66 are wip.

#8 Updated by sajolida 2015-09-21 02:58:38

  • Priority changed from Normal to Elevated
  • Target version changed from Tails_1.6 to Tails_1.7

Postponing and so raising priority.

#9 Updated by BitingBird 2015-09-22 15:35:39

  • Status changed from Confirmed to In Progress
  • % Done changed from 0 to 10

#10 Updated by sajolida 2015-09-23 10:16:41

  • Assignee changed from sajolida to tchou

Thanks for proposing wording for 31 and 65.

I applied them in Git in branch web/10104-windows-tchou. Please fetch it and work from there from now on if you want to modify anything.

Here are some comments:

  • The first step (Download and verify) will not exist as such but will actually be the browser extension. In that context where would you add your message? On the last screen of the browser extension (see slide 14)? Furthermore, it’s really duplicating what’s in the first sentence of the next section. You have “Now, it’s time to copy this ISO image on a first USB stick as a temporary Tails.” while the next section starts with “In this step, you will install a temporary Tails by copying the Tails ISO image on a first USB stick”. This feels like needless duplication to me. I would personally get rid of this one.
  • I moved the congratulations that you wrote for “after the install the final Tails section” until after the “Restart on the final Tails” section as this can also be a tricky part.
  • I moved what you called “last recommendations to a dedicated section”. But then I felt like “Subscribe to our newsletter” should be in there as well, so I did that in 3744350. Tell me what you think.
  • I created a class=“trophy” style with a cheezy trophy as icon (taken from the old GNOME theme as the other ones for consistency). Feel free to propose something better.

This is the last bit that blocks more from moving on to writing all the other scenarios, so let’s try to solve this quickly.

#11 Updated by sajolida 2015-09-24 11:20:18

  • blocked by deleted (Feature #9444: Assistant: Explain how to verify that the source USB is up-to-date)

#12 Updated by tchou 2015-09-25 01:13:05

sajolida wrote:
> Thanks for proposing wording for 31 and 65.
>
> I applied them in Git in branch web/10104-windows-tchou. Please fetch it and work from there from now on if you want to modify anything.

I’va build the ikiwiki in this branch, but I don’t have my wording (realy old version).

> Here are some comments:
>
> * The first step (Download and verify) will not exist as such but will actually be the browser extension. In that context where would you add your message? On the last screen of the browser extension (see slide 14)? Furthermore, it’s really duplicating what’s in the first sentence of the next section. You have “Now, it’s time to copy this ISO image on a first USB stick as a temporary Tails.” while the next section starts with “In this step, you will install a temporary Tails by copying the Tails ISO image on a first USB stick”. This feels like needless duplication to me. I would personally get rid of this one.

I would do the opposite, remove it from the section. Keep in the section only instructions, and in the “trophy” section as reward and introduction.

> * I moved the congratulations that you wrote for “after the install the final Tails section” until after the “Restart on the final Tails” section as this can also be a tricky part.
I could not review it. I’ve put it there because the user (in this case) already succed in booting.

> * I moved what you called “last recommendations to a dedicated section”. But then I felt like “Subscribe to our newsletter” should be in there as well, so I did that in 3744350. Tell me what you think.
I could not review it, but while I was writing it, I was thinking about this issue.

> * I created a class=“trophy” style with a cheezy trophy as icon (taken from the old GNOME theme as the other ones for consistency). Feel free to propose something better.
Could not review it, but maybe we will not need it. The step icons will be the big trophys. Anyway, I think we need a

<div class="something"></div>

to style this inter-sections (maybe it’s what you did).

> This is the last bit that blocks more from moving on to writing all the other scenarios, so let’s try to solve this quickly.

#13 Updated by sajolida 2015-09-25 09:08:40

> I’va build the ikiwiki in this branch, but I don’t have my wording (realy old version).

You can use this Git command to see my work on this branch

git diff origin/master...origin/web/10104-windows-tchou

The last commit on the branch should be bc3dbde.

>> * The first step (Download and verify) will not exist as such but will actually be the browser extension. In that context where would you add your message? On the last screen of the browser extension (see slide 14)? Furthermore, it’s really duplicating what’s in the first sentence of the next section. You have “Now, it’s time to copy this ISO image on a first USB stick as a temporary Tails.” while the next section starts with “In this step, you will install a temporary Tails by copying the Tails ISO image on a first USB stick”. This feels like needless duplication to me. I would personally get rid of this one.
>
> I would do the opposite, remove it from the section. Keep in the section only instructions, and in the “trophy” section as reward and introduction.

Note that this has proven to be problematic only for the congratulation
message after the Download and verify step. So I removed this whole
section from that page with d0026ef as it will actually not exist as
part of these instructions and will be replace by the ISO verification
extension page.

I let yourself reconsider adding a congratulation message on this page
as a subtask of Feature #8566.

>> * I moved the congratulations that you wrote for “after the install the final Tails section” until after the “Restart on the final Tails” section as this can also be a tricky part.
>
> I could not review it. I’ve put it there because the user (in this case) already succed in booting.

After merging the infography from web/9206-steps-prototype into this
branch, it’s clear to me that you’re right: the trophy should go right
after the infography of the final Tails.

Still, I’m worried about people thinking that they are already using the
final Tails while still being in a working session on the temporary
Tails. Maybe we should move the step “Shutdown the computer” into this
section. But let’s see if this is problematic during the user testing
session before working to hard on this.

I’ll upload a screenshot for you to see where we’re at.

#14 Updated by sajolida 2015-09-25 09:18:41

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

Actually, I tried 5 different screenshot extensions for Firefox and none of them worked properly. I think there’s something in Torbutton that prevents extensions from capturing more than what’s actively displayed on the page.

#15 Updated by sajolida 2015-09-25 09:27:36

But hey, here is the built HTML.

#16 Updated by tchou 2015-09-28 01:46:22

  • Assignee changed from tchou to sajolida
  • QA Check deleted (Ready for QA)

Just reading the html document, few comments:

- the “last_recommendations” is for me a trophy section too
- I would like to finish in a more “use” way than talk about problems and support (I wrote " Time to run Tails!", could be someting else)

#17 Updated by sajolida 2015-09-28 10:04:09

All-right, first from a process point of view. This ticket was called “Refine Windows scenario (tchou’s plate)” and I would have preferred seen you more involved in implementation. I’m fine with helping you getting up to speed with respect to implementation technique but keep in mind that this is as much your duty than mine.

Apart from that, here is what I did to solve you last concerns:

  • Made last recommendations a trophy section with 8370756.
  • Moved a positive note about usage at the end with 8b73e2f.

So I guess we’re done with this ticket and I’ll merge this branch.

#18 Updated by sajolida 2015-09-28 10:05:35

  • Status changed from In Progress to Resolved
  • % Done changed from 10 to 100

Applied in changeset commit:9b1abf99855f4abb601c00c6b234e9a3ab24e797.

#19 Updated by sajolida 2015-09-28 10:07:05

  • Assignee deleted (sajolida)