Ubuntu Packaging Guide

If you ever were interested in Ubuntu Development, I’m sure you came across the Ubuntu Packaging Guide. It served us well, but it became harder and harder to maintain. Because some parts are used in other wiki articles as well, we are making heavy use of includes, some other parts are slightly confusing as well.

We had a long discussion at UDS and came up with a plan. The idea was to write the articles in a task-based manner. So if you want to patch a package and get it included in Ubuntu, there will be an article for that. If you want to update package to a new upstream version, there’s going to be an article for that as well, and so on.

We kick-started the initiative and will use the ubuntu-packaging-guide project in Launchpad to coordinate our work. The general idea is:

  • Go through the list of articles we want to write.
  • Use merge proposals to review the new articles or updates together as a team.
  • Make use of parts of the old packaging guide and massage them into bite-size articles.
  • Package the result, put up a HTML and PDF guide on a canonical location.
  • Get it translated.

If you want to help out or have feedback, please feel free to help us out. Just

branch lp:ubuntu-packaging-guide

and file a bug report or propose a merge.

This is going to make it a lot easier to get involved. Get involved and stay tuned for more news!

  • Mariano

    I really like this.
    Way to go!

  • Joel

    Sounds good. Look forward to the updated version of the Packaging Guide.

  • Toxicbits


  • Andrea Carpineti

    uhm…I know I’m late, I hope the new packaging guide is still a work in progress. I don’t know if this is the right place to give some feedback…anyway I’m trying to help with Ubuntu just from a couple of months and so I use the packaging guide almost everyday. Some points:
    1) I believe the use of numbered sections is preferable. Moving through the guide trying to understand where we are only form the headers size is pretty annoying.
    2) I believe could be useful add some example about how to fix FTBFS bugs
    3) Provide a printable version (pdf, ps…)

    tks for your work Daniel!

  • Andrea Carpineti

    Really thanks for your prompt answer Daniel. Better reading your post I realized that the right place to raise these observations is Launchpad so I filed a new bug available at https://bugs.launchpad.net/ubuntu-packaging-guide/+bug/737455
    Please read there, I hope it is understandable…despite my terrible English.

    • Thanks a bunch for your comments. And no, your English is not terrible! 🙂