Re: [Tails-dev] Please review feature/assymetric_gpgApplet [sic!]
On 27/09/12 15:38, anonym wrote: > 27/09/12 15:19, intrigeri wrote: >> hi, >> >> anonym wrote (27 Sep 2012 13:09:17 GMT) : >>> doc/encryption_and_privacy/openpgp_passphrase_encryption (symmetric) >>> >> >>> The context menu for gpgApplet is now different, so both screenshots >>> (encryption and decryption) have to be updated. >> >> While we're at it, we could drop screenshots (as adviced by GNOME >> documentation guidelines, that some of us found very inspiring) and >> get rid of this problem. > > At first I intuitively felt strongly opposed to this, but after reading > the relevant part of GNOME-STYLE [1] and thinking some about this, I now > agree. I still think we should keep the screenshot for locating the > applet, though. > > [1] > http://developer.gnome.org/gdp-style-guide/stable/infodesign-8.html.en#infodesign-10 Exactly. We should try to limit the number of screenshot but not remove not all of them. For example, we should keep the ones who explain where is the applet, and what it looks like. >>> doc/encryption_and_privacy/openpgp_with_gedit (asymmetric) >>> -- >> >>> This page should be renamed since gpgApplet is to be used, not gedit. >>> Perhaps "openpgp_public_key" is a better name. >> >> The symmetric one is called "openpgp_passphrase_encryption", so >> perhaps we want to have this one contain "_encryption" too? > > Sure. Let's say "openpgp_public_key_encryption" then. That's what I was going to propose. >>> Actually there may be a point in uniting these pages into a single >>> one now since the same tool is used in both cases. Thoughts? >> >> I'm not sure "the same tool is used" is a good criterion for deciding >> how we organize end-user documentation. >> >> These are pretty different usecases, probably targetting quite >> different people, so I'd rather keep separate (shorter) pages. >> >> E.g. some people use symmetric encryption, and don't even know any >> other kind of encryption exists, so pointing them to a page where both >> are documented may be an additional factor of confusion. Keeping these >> pages separate also makes it easier to link to the one or the other. > > You may be right. OTOH, some parts will be (largely) duplicated, like > how to find the applet in the notification area, the explanation that > gpgApplet operates on the clipboard, and how to decrypt/verify stuff. I agree with intrigeri. Those should be separate pages. In case parts are really duplicated, I sometimes use inline directives to factorize the common parts in a small dummy page. See: /doc/first_steps/manual_usb_installation.intro/ /doc/first_steps/manual_usb_installation/ /doc/first_steps/manual_usb_installation/linux/ Feel free to comment… Regarding my commitment to doing that. I really want to do it. I'm pretty busy there days but I'll try to work on that on Friday, and Saturday. This project is more motivating than ever, but the pace of releases is really hard for me to cope with :( signature.asc Description: OpenPGP digital signature ___ tails-dev mailing list tails-dev@boum.org https://mailman.boum.org/listinfo/tails-dev
Re: [Tails-dev] Please review feature/assymetric_gpgApplet [sic!]
intrigeri wrote (29 Sep 2012 18:38:23 GMT) : > How about creating a ticket page for it? There is already one, actually: https://tails.boum.org/todo/gpgapplet:_public_key_support/ ___ tails-dev mailing list tails-dev@boum.org https://mailman.boum.org/listinfo/tails-dev
Re: [Tails-dev] Please review feature/assymetric_gpgApplet [sic!]
Hi! Once again, I had to search my mailbox to find the status of this task (sorry, I'm ill today and my memory is bad). How about creating a ticket page for it? ___ tails-dev mailing list tails-dev@boum.org https://mailman.boum.org/listinfo/tails-dev
Re: [Tails-dev] Please review feature/assymetric_gpgApplet [sic!]
27/09/12 15:19, intrigeri wrote: > hi, > > anonym wrote (27 Sep 2012 13:09:17 GMT) : >> doc/encryption_and_privacy/openpgp_passphrase_encryption (symmetric) >> > >> The context menu for gpgApplet is now different, so both screenshots >> (encryption and decryption) have to be updated. > > While we're at it, we could drop screenshots (as adviced by GNOME > documentation guidelines, that some of us found very inspiring) and > get rid of this problem. At first I intuitively felt strongly opposed to this, but after reading the relevant part of GNOME-STYLE [1] and thinking some about this, I now agree. I still think we should keep the screenshot for locating the applet, though. [1] http://developer.gnome.org/gdp-style-guide/stable/infodesign-8.html.en#infodesign-10 >> doc/encryption_and_privacy/openpgp_with_gedit (asymmetric) >> -- > >> This page should be renamed since gpgApplet is to be used, not gedit. >> Perhaps "openpgp_public_key" is a better name. > > The symmetric one is called "openpgp_passphrase_encryption", so > perhaps we want to have this one contain "_encryption" too? Sure. Let's say "openpgp_public_key_encryption" then. >> Actually there may be a point in uniting these pages into a single >> one now since the same tool is used in both cases. Thoughts? > > I'm not sure "the same tool is used" is a good criterion for deciding > how we organize end-user documentation. > > These are pretty different usecases, probably targetting quite > different people, so I'd rather keep separate (shorter) pages. > > E.g. some people use symmetric encryption, and don't even know any > other kind of encryption exists, so pointing them to a page where both > are documented may be an additional factor of confusion. Keeping these > pages separate also makes it easier to link to the one or the other. You may be right. OTOH, some parts will be (largely) duplicated, like how to find the applet in the notification area, the explanation that gpgApplet operates on the clipboard, and how to decrypt/verify stuff. Cheers! signature.asc Description: OpenPGP digital signature ___ tails-dev mailing list tails-dev@boum.org https://mailman.boum.org/listinfo/tails-dev
Re: [Tails-dev] Please review feature/assymetric_gpgApplet [sic!]
hi, anonym wrote (27 Sep 2012 13:09:17 GMT) : > Let's make sure this gets merged in time for the Tails 0.14 freeze Sure! :) > That will require an overhaul of the current documentation on how to > use OpenPGP. I had a quick look and this is what has to be updated: > doc/encryption_and_privacy/openpgp_passphrase_encryption (symmetric) > > The context menu for gpgApplet is now different, so both screenshots > (encryption and decryption) have to be updated. While we're at it, we could drop screenshots (as adviced by GNOME documentation guidelines, that some of us found very inspiring) and get rid of this problem. > doc/encryption_and_privacy/openpgp_with_gedit (asymmetric) > -- > This page should be renamed since gpgApplet is to be used, not gedit. > Perhaps "openpgp_public_key" is a better name. The symmetric one is called "openpgp_passphrase_encryption", so perhaps we want to have this one contain "_encryption" too? > Actually there may be a point in uniting these pages into a single > one now since the same tool is used in both cases. Thoughts? I'm not sure "the same tool is used" is a good criterion for deciding how we organize end-user documentation. These are pretty different usecases, probably targetting quite different people, so I'd rather keep separate (shorter) pages. E.g. some people use symmetric encryption, and don't even know any other kind of encryption exists, so pointing them to a page where both are documented may be an additional factor of confusion. Keeping these pages separate also makes it easier to link to the one or the other. Cheers, -- intrigeri | GnuPG key @ https://gaffer.ptitcanardnoir.org/intrigeri/intrigeri.asc | OTR fingerprint @ https://gaffer.ptitcanardnoir.org/intrigeri/otr.asc ___ tails-dev mailing list tails-dev@boum.org https://mailman.boum.org/listinfo/tails-dev
Re: [Tails-dev] Please review feature/assymetric_gpgApplet [sic!]
24/08/12 09:21, intrigeri wrote: > anonym wrote (22 Aug 2012 08:53:02 GMT) : >> All is merged into experimental. > > Thanks. > > Unfortunately, I forgot to merge it at pre-freeze time, and > unfortunately nobody noticed it in time since the todo/qa tag was not > set after the last development round, so that will be stuff for the > 0.14 merge window. I updated the ticket to reflect the current state > of things. Sorry about that :( Let's make sure this gets merged in time for the Tails 0.14 freeze (which seems to be October 9th). That will require an overhaul of the current documentation on how to use OpenPGP. I had a quick look and this is what has to be updated: doc/encryption_and_privacy/openpgp_passphrase_encryption (symmetric) The context menu for gpgApplet is now different, so both screenshots (encryption and decryption) have to be updated. doc/encryption_and_privacy/openpgp_with_gedit (asymmetric) -- This page should be renamed since gpgApplet is to be used, not gedit. Perhaps "openpgp_public_key" is a better name. Then the pages content has to be heavily re-worked for the same reason. Actually there may be a point in uniting these pages into a single one now since the same tool is used in both cases. Thoughts? sajolida, were you committed to this? Cheers! signature.asc Description: OpenPGP digital signature ___ tails-dev mailing list tails-dev@boum.org https://mailman.boum.org/listinfo/tails-dev
Re: [Tails-dev] Please review feature/assymetric_gpgApplet [sic!]
On Fri, Aug 24, 2012 at 09:21:22AM +0200, intrigeri wrote: > anonym wrote (22 Aug 2012 08:53:02 GMT) : > > All is merged into experimental. > > Thanks. > > Unfortunately, I forgot to merge it at pre-freeze time, and > unfortunately nobody noticed it in time since the todo/qa tag was not > set after the last development round, so that will be stuff for the > 0.14 merge window. I updated the ticket to reflect the current state > of things. Sorry about that :( > > (To clarify: when, after I've reviewed a branch, I'm asking for more > development to be done before merging, then I'm setting the ticket > back to todo/code state, and I consider it's the responsibility of the > branch/ticket "holder" to change it back to todo/qa once they consider > the issues raised by the reviewer were fixed. If we agree on that, > perhaps it's material for our upcoming "how changes go into Tails" > improved process doc.) Sounds like a good process, agree to add this in the documentation. bert. ___ tails-dev mailing list tails-dev@boum.org https://mailman.boum.org/listinfo/tails-dev
Re: [Tails-dev] Please review feature/assymetric_gpgApplet [sic!]
anonym wrote (22 Aug 2012 08:53:02 GMT) : > All is merged into experimental. Thanks. Unfortunately, I forgot to merge it at pre-freeze time, and unfortunately nobody noticed it in time since the todo/qa tag was not set after the last development round, so that will be stuff for the 0.14 merge window. I updated the ticket to reflect the current state of things. Sorry about that :( (To clarify: when, after I've reviewed a branch, I'm asking for more development to be done before merging, then I'm setting the ticket back to todo/code state, and I consider it's the responsibility of the branch/ticket "holder" to change it back to todo/qa once they consider the issues raised by the reviewer were fixed. If we agree on that, perhaps it's material for our upcoming "how changes go into Tails" improved process doc.) ___ tails-dev mailing list tails-dev@boum.org https://mailman.boum.org/listinfo/tails-dev
Re: [Tails-dev] Please review feature/assymetric_gpgApplet [sic!]
21/08/12 21:02, intrigeri: > hi, > > anonym wrote (21 Aug 2012 15:31:13 GMT) : >> Please review the branch feature/assymetric_gpgApplet [sic!] which >> currently is merged into experimental. The associated ticket is >> todo/gpgapplet:_public_key_support, which lists what has to be done >> before it can be merged (given the review is ok), which is >> user documentation. > > Only other issues I've found after a quick testing session are: > > 1. The "Do you trust these keys?" window does not stay above the >main one. This is confusing if you misclick on something else, >given it's a modal window that's not listed in the taskbar. Very true. Fixed in commit 6b21dc8. > 2. The PO files are outdated. Done in commit f264b7e. Also seemed to require commit 56ba273 to be able to run ./refresh-translations. All is merged into experimental. Cheers! signature.asc Description: OpenPGP digital signature ___ tails-dev mailing list tails-dev@boum.org https://mailman.boum.org/listinfo/tails-dev
Re: [Tails-dev] Please review feature/assymetric_gpgApplet [sic!]
hi, anonym wrote (21 Aug 2012 15:31:13 GMT) : > Please review the branch feature/assymetric_gpgApplet [sic!] which > currently is merged into experimental. The associated ticket is > todo/gpgapplet:_public_key_support, which lists what has to be done > before it can be merged (given the review is ok), which is > user documentation. Only other issues I've found after a quick testing session are: 1. The "Do you trust these keys?" window does not stay above the main one. This is confusing if you misclick on something else, given it's a modal window that's not listed in the taskbar. 2. The PO files are outdated. That's all :) ___ tails-dev mailing list tails-dev@boum.org https://mailman.boum.org/listinfo/tails-dev
[Tails-dev] Please review feature/assymetric_gpgApplet [sic!]
Hi, Please review the branch feature/assymetric_gpgApplet [sic!] which currently is merged into experimental. The associated ticket is todo/gpgapplet:_public_key_support, which lists what has to be done before it can be merged (given the review is ok), which is user documentation. Cheers! signature.asc Description: OpenPGP digital signature ___ tails-dev mailing list tails-dev@boum.org https://mailman.boum.org/listinfo/tails-dev