"Ubuntu Packaging Guide"

Steve Langasek steve.langasek at ubuntu.com
Mon Jun 6 23:21:32 UTC 2011

On Mon, Jun 06, 2011 at 04:41:33PM -0400, Barry Warsaw wrote:
> On Jun 06, 2011, at 03:49 PM, Scott Kitterman wrote:

> >Right. Mostly what I need are docs that are easy enough to find the next time
> >it comes up because I'm old and forgetful.

> I agree that a cheat sheet would be a nice addition. :)

More than a nice addition, I would argue that this is the single most
important part of the documentation to get right (and that we have
collectively been failing at for some time).

I can remember several years ago that one of the great advantages of Ubuntu
over Debian for the budding developer was that Debian had the New Maintainer
Guide, and Ubuntu had nice short wiki pages that told you how to get started
and hit the ground running.  I feel like the playing field has been leveled
somewhat since then, but not in the direction I would've liked ;), because
there is a constant pressure to add more documentation.  That's not a bad
thing per se, but we need to be vigilant that we don't add this
documentation in the wrong place.  The "quick start guide" should be the
*first* place we direct new developers, with "would you like to know more?"
links available for them to drill down into; and if more documentation needs
to be added, it should be added on the individual detail pages.

I think the Ubuntu Packaging Guide represents a great opportunity for this
kind of refactoring to take place.  I don't get the impression that this has
happened yet.

Steve Langasek                   Give me a lever long enough and a Free OS
Debian Developer                   to set it on, and I can move the world.
Ubuntu Developer                                    http://www.debian.org/
slangasek at ubuntu.com                                     vorlon at debian.org
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 828 bytes
Desc: Digital signature
URL: <https://lists.ubuntu.com/archives/ubuntu-devel/attachments/20110606/dbd13724/attachment.pgp>

More information about the ubuntu-devel mailing list