= Overall summary =

Matthew Revell and Julian Edwards met on the 25th March to plan improvements to the help materials for Personal Package Archives. These mini-specs, and their associated blueprints, are the result.

= Mini Specs =

<<Anchor(basic-packaging)>>
== ppa-basic-packaging-guide ==

https://blueprints.launchpad.net/launchpad-documentation/+spec/ppa-basic-packaging-guide

 * Story: As a new PPA user, I want to learn how to create Ubuntu source packages so that I can upload them to my PPA and publish them.
 * Deliverables: A basic guide to Debian packaging, tailored specifically to Ubuntu PPA users. Should include explanation of dependencies in PPAs and also a (possibly separate) guide to versioning.
 * Full spec: none
 * Depends on: n/a
 * Story Points: 

<<Anchor(uploading)>>
== ppa-uploading-guide ==

https://blueprints.launchpad.net/launchpad-documentation/+spec/ppa-uploading-guide

 * Story: As a new PPA user, I want to learn how to upload my source packages to my PPA and how to deal with any subsequent errors.
 * Deliverables: A guide to uploading source packages to a PPA, including: 
  *dput
  * signing your package correctly
  * failure scenarios (error email or no email)
  * error messages with what to do next
   * e.g. once something has been published at a particular version, can never publish it again with that version number even if you delete it
  * success scenarios (what to look out for in the UI)
 * Full spec: none
 * Depends on: n/a
 * Story Points: 

<<Anchor(publication-lifecycle)>>
== ppa-publication-lifecycle ==

https://blueprints.launchpad.net/launchpad-documentation/+spec/ppa-publication-lifecycle

 * Story: As a PPA user, I want a quick reference to the lifecycle of a package as it makes its way through the PPA build and publication system to help me know what's happening at any time.
 * Deliverables: A reference guide describing the steps during the PPA publication lifecycle.
 * Full spec: none
 * Depends on: n/a
 * Story Points: 


<<Anchor(downloading-using)>>
== ppa-downloading-using ==

https://blueprints.launchpad.net/launchpad-documentation/+spec/ppa-publication-lifecycle

 * Story: As an Ubuntu user, I want to download and use packages from a PPA but I'm unsure of how to add the PPA to my system etc.
 * Deliverables: A guide to adding a PPA and its key to your software sources.
 * Full spec: none
 * Depends on: n/a
 * Story Points: