Adding PPAs pop-up confusing

[Bob-El]

I came across the "Read about installing" link in the paragraph "Adding this PPA to your system" on the page https://launchpad.net/~joh/+archive/ppa. In the pop-up window, there are instructions how to add the PPA. I found it confusing and I ended up installing the wrong PPA. I think a better, clearer instruction is in order.

The text under "Adding this PPA to your system" currently states, "You can update your system with unsupported packages from this untrusted PPA by adding ppa:joh/ppa to your system's Software Sources." Clicking on the link "(Read about installing)" causes a pop-up window to appear. Coupled with the information in the paragraph and the contents of the pop-up window, I misinterpreted the instructions. If would have been clearer to me if the paragraph had had been worded in such a way to link "ppa:joh/ppa" with the instructions.

I would like to suggest wording along these lines:
You can update your system with unsupported packages from this untrusted PPA by adding ppa:joh/ppa to your system's Software Sources. For instructions on how to do this, click on the link for details and, in the example given, replace "ppa:user/ppa-name" with "ppa:joh/ppa".

Then you can get rid of the reference to "ppa:gwibber-daily/ppa" (which is the repository I ended up adding to my system) in the pop-up window text.

[Julian Edwards (julian-edwards)]

There's quite a few bugs about the help text for adding PPAs.

[Bryan Quigley (bryanquigley)]

I think removing the current "Read about installing" link, and replacing with something like:

Learn more about PPAs: <link to https://help.launchpad.net/Packaging/PPA>
Learn more about Private PPAs: <https://help.launchpad.net/Packaging/InstallingFromAPrivatePPA>

only showing on the relevant PPA type of course. From lib/lp/soyuz/templates/archive-index.pt that looks doable with tal:condition="not: context/private">

Depending on how easy it is to test, I could also provide new private PPA installation instructions.