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

ppa-basic-packaging-guide

https://blueprints.edge.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:

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:

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: