Developer Documents

[Jordan Mantha]

On 4/19/06, Matthew East <mdke at ubuntu.com> wrote:
> On Wed, 2006-04-19 at 10:19 -0400, Jonathan Jesse wrote:
> > A part of the email about Edgy Eft (not sure that I like that name but oh
> > well) was the link to all of the specs tracked in Launchpad, and I notcied
> > there was one on Developer Documentation.  Does the packaging guide
> > meet/answer this spec and if so it should be updated.
> > https://wiki.ubuntu.com/DeveloperDocumentation is the link to the spec on the
> > Wiki.
>
> Yeah, it is a separate spec, Ian Jackson is working on it. Jordan has
> talked to him about its relationship with the packaging guide in the
> past, so will be able to tell you more.

Yeah, right now there are two specs, DeveloperDocumentation (an Ubuntu
version of the Debian Developer's Reference) and UbuntuPackagingGuide
(an introductory guide to packaging that we have done for Dapper) .
Ian Jackson has started the Ubuntu Developer's Reference but I'm not
sure it will make it into Dapper+1. I'll try to work with him as much
as possible to make sure the docs don't overlap too much and we cover
every thing we want to.

I'd really like to see some more documentation moving a user from from
a basic user (more or less where the current desktop guides leave off)
to a contributor/developer. I think the Server Guide, Packaging Guide,
and Developer's Reference should go a long way towards that goal. What
I'd like to see from Edgy is more Python and CLI documentation and
especially documentation that is area specific. For instance, I'd love
to write a bit on using Ubuntu/Python in the scientific arena and I
can imagine seeing documentation for Multimedia, Networking, Web
(wiki, webpage, etc), Education, Publishing, and so on.  It would be
nice to have "by users, for users" documentation that moves people
from just using Ubuntu for web browsing and email to something they
would think about using professionally. I might try to spec some stuff
out but I'd like to hear what you guys think as well.

-Jordan