Tails

#6 Updated by intrigeri 2017-09-04 16:59:07

Please consider using a target version that reflects the deadline: in my experience “Due date” doesn’t work well to plan one’s work.

#10 Updated by sajolida 2018-01-31 16:30:32

Here are some wild notes that I took during the UX sprint and might be useful for writing the doc:

• P2 was wondering where the software was installed. Trying to open it and remove it.
• P3: « I could use Tails more if I had all the software I use. It would make everything I use more secure. »
• P3 wondered if that would make her Tails one-of-a-kind and less
  anonymous. Tails is still the same, until you start and unlock your
  persistent storage. Since then we tried to clarify from the
  interface that the software was stored in the persistent storage.
• P6: « You could install only what you need as a way of having less stuff on Tails in general and so better security. »

#16 Updated by sajolida 2018-04-27 21:21:46

I had a look at your branch today. Please check the improvements that I
pushed to doc/14589-additional-software. I also merged them into
feature/14594-asp-gui.

Regarding your questions and the rest of the work:

• In the release notes, I try to reuse the screenshots from the doc if
  possible. So I have less work and less binary files in the Git repo.
• I think the warning on top of “Configuring additional APT
  repositories” should be more scary because it could allow people to
  install, for example, Skype or Dropbox on their Tails. But I’m not sure
  how…
• I think we should put the “Check” section before the “Remove” section.
  It would make sense in terms of the order in which people might want to
  perform the operations. Then it would also make it easier to mention the
  “Additional Software” configuration in the “Remove” section, and we
  should do that too.
• We should mention in the relevant places that installing a package
  requires administration rights (and maybe that installing them
  automatically doesn’t require one). I didn’t test if you need an
  administration password to remove a package from the “Additional
  Package” configuration.
• What about the work on the other pages? Do have a TODO list elsewhere
  for that?

#18 Updated by emmapeel 2018-04-28 07:26:30

sajolida wrote:

…

> * I think the warning on top of “Configuring additional APT
> repositories” should be more scary because it could allow people to
> install, for example, Skype or Dropbox on their Tails. But I’m not sure
> how…

Yes, definitely. Also the other day one user in irc had problems because he thought it was needed to change the repos to install software, so I will edit it to make clear that it is not needed and also super dangerous (well, more dangerous than installing from the default repos)

> * What about the work on the other pages? Do have a TODO list elsewhere
> for that?

I was still using the pad we used…

#19 Updated by emmapeel 2018-04-28 10:04:45

sajolida wrote:
> * In the release notes, I try to reuse the screenshots from the doc if
> possible. So I have less work and less binary files in the Git repo.

Ok good so the place I chose was the correct.

> * I think we should put the “Check” section before the “Remove” section.
> It would make sense in terms of the order in which people might want to
> perform the operations.

That’s 087bc4570b

> Then it would also make it easier to mention the
> “Additional Software” configuration in the “Remove” section, and we
> should do that too.

that’s 8a60a72e58

> * We should mention in the relevant places that installing a package
> requires administration rights (and maybe that installing them
> automatically doesn’t require one).

As you cannot do anything on this page without and administration password, I added a note div on the top, advising that you need to add this password to do all the things mentioned on the page, see 248436da10

> I didn’t test if you need an
> administration password to remove a package from the “Additional
> Package” configuration.

Yes, you need an administration password to remove a package from the Additional Package config. But the remove button appears anyway. You get asked for the amnesia password, and also: it does not say anything about restarting Tails and adding it at boot. Shall I open a ticket about this?

> * What about the work on the other pages? Do have a TODO list elsewhere
> for that?

There are some subtickets to this one, and some TODOS on the pad. I want to move the pad complicated stuff to tickets later today, and fix the simple ones.

#20 Updated by sajolida 2018-04-28 10:49:44

> I was still using the pad we used…

I’ve seen that but, going through the pad again, I thought that it was
only about /doc/first_steps/additional_software but not about the rest
of the changes that we might still have to do in other places.

Can you double check with the post-its on your wall whatelse there is to
do outside of this page?

#22 Updated by Anonymous 2018-05-07 16:01:33

Can one of you please point me to the place where I can find the documentation? I want to send out a call for testing ASAP and add this information to it. If I don’t get an answer early enough I will try to use the branch doc/14589-additional-software.

#23 Updated by Anonymous 2018-05-07 16:11:47

BTW this branch doc/14589-additional-software does not merge cleanly with master, can you please fix that?

#25 Updated by sajolida 2018-05-22 20:25:32

I reviewed everything we did so far and here is a list of pending issues (except pending work on subtasks of this ticket):

• Please use the GNOME icon corresponding to the ‘x’ button.

See git grep symbolic -- "*.*m*".

The GNOME icons are in /usr/share/icons/gnome.

• List removing through X button in Additional Software as the first
  option because it’s the simpliest and quickest.

• Should we move “After the package is removed” as part of “Synaptic”?
  Because this notification doesn’t appear when clicking the X button
  in Additional Software. I think that moving it below Synaptic would
  help people understand that it won’t appearing when clicking the X
  button in Additional Software.

• I don’t think we should add “Install additional software” to
  /doc/first_steps/persistence.mdwn as you did in 144442db02 because
  in the general index it’s not a subpage of it.

• Please explain the need for the admin password right at the place
  where it is needed (instead or in addition to your note): when
  adding and removing software (but not to use them). During the user
  testing I saw how people scan these instructions and your note on
  the top of the page wouldn’t be helpful for them.

For example, write “When starting Tails, [[set up an administration
password|doc/first_steps/startup_options/administration_password.”
as first step.

You could even add step to enter the administration password.

• The warning on top of “Configuring additional APT repositories” is
  still not scarier.

• We already have a ticket about improving the UX when no admin
  password is set: Feature #9554. No need to create a new one.

• Mention Dotfiles. Maybe as a tip for advanced users. Because I don’t
  expect Dotfiles to make sense or be able to use by people who are
  not advanced Linux users.

I also pushed a bunch of fixes. Make sure to fetch
origin/doc/14589-additional-software.

#26 Updated by sajolida 2018-05-22 20:26:18

Please reassing this ticket to me once you think that all issues are solved.

I’ll refrain from reviewing your work again until then.

#27 Updated by emmapeel 2018-06-04 11:13:46

sajolida wrote:
> I reviewed everything we did so far and here is a list of pending issues (except pending work on subtasks of this ticket):

Thanks for your thorough review.

> * Please use the GNOME icon corresponding to the ‘x’ button.

I’ve done that in 411968a695. I thought better to keep the long icon name, because it was the original name on the icons directory.

> * List removing through X button in Additional Software as the first
> option because it’s the simpliest and quickest.

That’s 94ba0c7e08.

>
> * Should we move “After the package is removed” as part of “Synaptic”?
> Because this notification doesn’t appear when clicking the X button
> in Additional Software. I think that moving it below Synaptic would
> help people understand that it won’t appearing when clicking the X
> button in Additional Software.

I left it at the end, so now it comes after Synaptic and apt, which also triggers
that window.

> * I don’t think we should add “Install additional software” to
> /doc/first_steps/persistence.mdwn as you did in 144442db02 because
> in the general index it’s not a subpage of it.

I found that link when moving the links that pointed to the original
feature, but I left if because I though people will maybe look for
something about Additional Software there. I have taken it out with
28a782d938

> * Please explain the need for the admin password right at the place
> where it is needed (instead or in addition to your note): when
> adding and removing software (but not to use them). During the user
> testing I saw how people scan these instructions and your note on
> the top of the page wouldn’t be helpful for them.

Yeah I saw this feedback too. I add it as first step where is needed with
3f283bd9ab

> * The warning on top of “Configuring additional APT repositories” is
> still not scarier.

I did my best on b0fd3f5b1c

>
> * We already have a ticket about improving the UX when no admin
> password is set: Feature #9554. No need to create a new one.
>
> * Mention Dotfiles. Maybe as a tip for advanced users. Because I don’t
> expect Dotfiles to make sense or be able to use by people who are
> not advanced Linux users.

Added a note with d4a055d43b. I think a lot of non-technical people is
going to be in need of a dotfiles link, but they may not even know it.
ref: Bug report: 19ce6424149c31e34a63f2b966df51b8

> I also pushed a bunch of fixes. Make sure to fetch
> origin/doc/14589-additional-software.

Cool! I like contractions too!

#29 Updated by sajolida 2018-06-28 18:23:49

>> * Please use the GNOME icon corresponding to the ‘x’ button.
>
> I’ve done that in 411968a695. I thought better to keep the long icon name, because it was the original name on the icons directory.

I prefer keeping the same name as in /usr/share/icon.

>> * Should we move “After the package is removed” as part of “Synaptic”?
>> Because this notification doesn’t appear when clicking the X button
>> in Additional Software. I think that moving it below Synaptic would
>> help people understand that it won’t appearing when clicking the X
>> button in Additional Software.
>
> I left it at the end, so now it comes after Synaptic and apt, which also triggers
> that window.

It’s good!

>> * The warning on top of “Configuring additional APT repositories” is
>> still not scarier.
>
> I did my best on b0fd3f5b1c

It’s better! I polished it with c7f2d5d67c.

>> * Mention Dotfiles. Maybe as a tip for advanced users. Because I don’t
>> expect Dotfiles to make sense or be able to use by people who are
>> not advanced Linux users.
>
> Added a note with d4a055d43b. I think a lot of non-technical people is
> going to be in need of a dotfiles link, but they may not even know it.
> ref: Bug report: 19ce6424149c31e34a63f2b966df51b8

Good! Most users won’t be able to use the Dotfiles feature either but
there’s not much else we can do about that right now…

#30 Updated by sajolida 2018-06-28 18:35:18

So I think we’re good with this ticket. Congrats!

But there are still a bunch of subtasks open so I’m leaving this one as “Dev Needed”.

#32 Updated by sajolida 2018-07-31 07:29:12

Emma: Please make sure you’re done with your work before August 13 because after that I’ll be off traveling and doing sprints until 3.9!

#33 Updated by Anonymous 2018-08-07 14:39:15

Ping @emmapeel. 6 days left to fix the remaining subtickets. It seems like the main part of the documentation has already passed review, which is great!

#34 Updated by intrigeri 2018-08-07 18:28:54

I’ve merged origin/feature/14594-asp-gui into this branch in order to fix the ISO build.

#35 Updated by intrigeri 2018-08-13 11:01:00

And I’ve merged this branch into feature/14594-asp-gui because that’s what we want to merge within 48h.

#38 Updated by intrigeri 2018-08-14 20:41:54

> I finished the work on this and merged it again in feature/14594-asp-gui.

Amazing!