launchpad-doc team mailing list archive

[ChameleonDave <david.short@xxxxxxxxxxxx>]

Well, I'm new to creating repositories, and I found the way the guide
described it to be unenlightening.  I felt that comments like "If you're
already familiar with uploading to the Ubuntu primary archive" showed
that the emphasis was on people who are already experienced in creating
packages and placing them in repos, and that the guide was only for
showing such people how to use a PPA.

For example, it assumes you already have the dput command on your
machine, and that you know what it does.  Through experimentation, I
realised that you have to point dput at your .changes file, but it ends
up uploading all related files too.  It's also not clear that although
your .deb will be uploaded, it will not appear in your PPA repo.
Instead, it seems that a new one will be compiled out of your source
code.

It also seems to be important to make sure that the e-mail addresses
mentioned in the files (and their corresponding PGP keys) are the same
as the ones attached to your Launchpad account.

It would be better if it assumed no prior knowledge and worked from there. 
That doesn't mean it has to explain every little thing.  Hyperlinks pointing at sub-tutorials would be sufficient.

It's also out of date.  For example, it refers to things like "Activate
PPA" which are now phrased differently on the site.  It makes the user
lose confidence in the relevance of the guide.

I can't really specify any more data on what is missing, because I
myself do not understand the process yet.  I still haven't managed to
add anything to my PPA.  I'm going to make my package again from scratch
and see where I slipped up.  When I finally manage to get it all
working, I'll be able to look back and think about what trouble-shooting
advice would have saved me time if it had been in the guide.

Keep up the good work!

-- 
PPAQuickStart guide is outdated and incomplete
https://bugs.launchpad.net/bugs/250061
You received this bug notification because you are a member of Launchpad
Documentation Team, which is subscribed to Launchpad Documentation.