Archive 'subscription' terminology is confusing

[Michael Nelson]

Discussion on IRC:

<noodles> mpt: IMO, when we have the infrastructure that allows us to see quickly which people are using their private access (like a last_download db field that we can filter by etc.) then we could simply create the individual tokens when the team 'subscription' is created.
<noodles> mpt: but until that time, we want to be able to provide the owners of private archives with that information (ie. which users have activated their subscription), hence the current method.
<noodles> (which could be improved so that there's no confirmation etc.)
<mpt> noodles, that would be cool, if it would mean you could get rid of the button. :-)
<mpt> In the meantime, I suggest referring to "have access", "grant access" etc rather than "subscribe", and changing "Confirm" to "Show Me How" or similar that (a) generates the token if it's not generated yet and (b) reveals instructions on adding the PPA to sources.list.

[Matthew Paul Thomas (mpt)]

Possibly-incomplete list of places to change the wording:
1. The form for a PPA owner to grant access (including <title> and form labels)
2. The message after submitting the form, "You have subscribed <person> to <ppa>"
3. The e-mail message sent out, "New PPA subscription for..." etc
4. https://launchpad.net/people/+me/+archivesubscriptions
5. The private PPA page itself, if it lists people who have access.

[Michael Nelson (michael.nelson)]

I've factored out the confirmation-removal-step mentioned in the description to a separate bug 393375.

[Michael Nelson (michael.nelson)]

Hi Matthew,

Can you please check through the screenshots at:

https://chinstrap.canonical.com/~michaeln/bug-386355/

and let me know if there are any other wording changes that you would like?

Thanks!

Also, the emails have been reworded as follows:

New access email
==========

Hello %(recipient_name)s,

Launchpad: access to a private archive
--------------------------------------

%(registrant_name)s has granted you access to a private software archive hosted by Launchpad.

To start downloading and using software from this archive you need to view your access details by visiting this link:

<%(recipient_subscriptions_url)s>

You can find out more about %(registrant_name)s here:

<%(registrant_profile_url)s>

If you'd prefer not to use software from this archive, you can safely ignore this email. However, if you have any concerns you can contact the Launchpad team by emailing <email address hidden>

Regards,
The Launchpad team

Cancelled access email
==============
Hello %(recipient_name)s,

Launchpad: cancellation of archive access
-----------------------------------------

Your access to the private software archive "%(ppa_name)s", which is hosted by Launchpad, has been cancelled.

You will now no longer be able to download software from this archive. If you think this cancellation is in error, you should contact the owner of the archive to verify it.

You can contact the archive owner by visiting his/her Launchpad page here:

<%(ppa_owner_url)s>

If you have any concerns you can contact the Launchpad team by emailing <email address hidden>

Regards,
The Launchpad team

[William Grant (wgrant)]

The new access email doesn't tell me the archive to which it refers.

The cancelled access email speaks of the archive owner as if it's a human - it will almost always be a team.

[Michael Nelson (michael.nelson)]

Thanks William,

I've updated the text for the emails, and the other images should be viewable at the following url:

http://people.ubuntu.com/~michaeln/bug-386355/

PPA-subscription-new email template:
======================
Hello %(recipient_name)s,

Launchpad: access to a private archive
--------------------------------------

%(registrant_name)s has granted you access to a private software archive "%(ppa_name)s", which is hosted by Launchpad.

To start downloading and using software from this archive you need to view your access details by visiting this link:

<%(recipient_subscriptions_url)s>

You can find out more about %(registrant_name)s here:

<%(registrant_profile_url)s>

If you'd prefer not to use software from this archive, you can safely ignore this email. However, if you have any concerns you can contact the Launchpad team by emailing <email address hidden>

Regards,
The Launchpad team

PPA-subscription cancelled template:
======================
Hello %(recipient_name)s,

Launchpad: cancellation of archive access
-----------------------------------------

Your access to the private software archive "%(ppa_name)s", which is hosted by Launchpad, has been cancelled.

You will now no longer be able to download software from this archive. If you think this cancellation is in error, you should contact the owner of the archive to verify it.

You can contact the archive owner by visiting their Launchpad page here:

<%(ppa_owner_url)s>

If you have any concerns you can contact the Launchpad team by emailing <email address hidden>

Regards,
The Launchpad team

[Diogo Matsubara (matsubara)]

Fixed in devel r8876.

[Matthew Paul Thomas (mpt)]

Thank you!