Tails

#1 Updated by sajolida 2016-01-14 11:08:02

• Assignee changed from sajolida to spriver
• QA Check changed from Ready for QA to Info Needed

This is marked as “Ready for QA” but there’s no “Feature Branch” set. Where is the work I should review?

#2 Updated by spriver 2016-01-14 11:14:33

• Assignee changed from spriver to sajolida
• QA Check changed from Info Needed to Ready for QA
• Feature Branch set to spriver:doc/10935-persistence-passphrase

My repo is at: https://gitlab.com/spriver/tails.git

#3 Updated by sajolida 2016-01-15 16:51:19

• Status changed from New to Confirmed
• Assignee changed from sajolida to spriver
• QA Check changed from Ready for QA to Dev Needed

Cool! This one is almost ready. A few nitpicking comments and recommendations for future work:

* Update config/base_branch to “testing”.

* What about removing the big titles of the section? We have 10 steps
in total. That’s quite a bit but should be ok.

* What about removing the step “verify that the device corresponds to
your device”? This would only be helpful for people with multiple
Tails devices plugged in the same machine so maybe it’s not worth
bothering everybody with this. I know I wrote this myself a while ago :)

* We need to clarify the doc style for menus without labels like for

Bug #10934 but for the time being, let’s stick to what we’re been doing
in /install/linux/usb.

• We often have to point to the “administration password”
  instructions, so I think we can reuse a shorter formulation
  everytime. What about “1. Start Tails and set up an administration
  password.” (like in check_file_system.mdwn) or “Set up an
  administration password when starting Tails”?
• Markdown calculates automatically the number of the steps, so
  there’s no need to number them manually in the doc. Actually I prefer
  always writing “1. ”. So your change to line 34 was not needed but
  that’s ok.
• We say “choose” for choosing option from a menu. “Select” is for
  selections things in a drop-dop, a selector, etc. See
  https://developer.gnome.org/gdp-style-guide/2.32/gdp-style-guide.html#gnome-glossary-user-actions. So
  you’re step 2 needs to be adjusted.
• Use … to encode a true ellipsis instead of three dots in
  step 2.
• Your step 5 could probably be shorten with something like “In the
  confirmation dialog, enter your administration password and click
  Authenticate”." About the phrasing of clicks see GDSG “click”.
• We underline titles with ‘=’ upto the lenght of the title :)

#6 Updated by spriver 2016-01-17 18:35:30

• Assignee changed from spriver to sajolida
• QA Check changed from Dev Needed to Ready for QA

sajolida wrote:
> Cool! This one is almost ready. A few nitpicking comments and recommendations for future work:
>
> * Update config/base_branch to “testing”.
I tried to rebase on testing, but config/base_branch stayed devel. I hope for this time this is okay?

> * What about removing the big titles of the section? We have 10 steps
> in total. That’s quite a bit but should be ok.
Did it. Good idea, the page is a lot more clear now.

> * What about removing the step “verify that the device corresponds to
> your device”? This would only be helpful for people with multiple
> Tails devices plugged in the same machine so maybe it’s not worth
> bothering everybody with this. I know I wrote this myself a while ago :)
Understood and did it ;)

> * We need to clarify the doc style for menus without labels like for
> Bug #10934 but for the time being, let’s stick to what we’re been doing
> in /install/linux/usb.
I included the icon now. I think this should be clear enough? (I’m not a fan of huge screenshots and try to avoid them as good as possible)

> * We often have to point to the “administration password”
> instructions, so I think we can reuse a shorter formulation
> everytime. What about “1. Start Tails and set up an administration
> password.” (like in check_file_system.mdwn) or “Set up an
> administration password when starting Tails”?
Shortened it.

> * Markdown calculates automatically the number of the steps, so
> there’s no need to number them manually in the doc. Actually I prefer
> always writing “1. ”. So your change to line 34 was not needed but
> that’s ok.
Changed it back together with removing the titles.

> * We say “choose” for choosing option from a menu. “Select” is for
> selections things in a drop-dop, a selector, etc. See
> https://developer.gnome.org/gdp-style-guide/2.32/gdp-style-guide.html#gnome-glossary-user-actions. So
> you’re step 2 needs to be adjusted.
> * Use … to encode a true ellipsis instead of three dots in
> step 2.
Changed it.

> * Your step 5 could probably be shorten with something like “In the
> confirmation dialog, enter your administration password and click
> Authenticate”." About the phrasing of clicks see GDSG “click”.
Changed it ;)

> * We underline titles with ‘=’ upto the lenght of the title :)

I pushed the updated branch, I hope the changes are okay (:

#7 Updated by sajolida 2016-01-29 19:48:00

• Status changed from Confirmed to Resolved
• Assignee deleted (sajolida)
• QA Check deleted (Ready for QA)
• Feature Branch changed from spriver:doc/10935-persistence-passphrase to doc/10935-persistence-passphrase

Perfect! I’m merging then!