List Info

Thread: Re: New developer documentation




Re: New developer documentation
user name
2007-01-26 11:27:39
On Jan 26, 2007, at 7:08 AM, Matt Zimmerman wrote: > Colin and I have put together a new landing page for developer > documentation, to supersede DeveloperResources and some other > incomplete or > outdated documentation: > > https://wiki.ubuntu.com/UbuntuDevelopment > Rockin' ! This should help new people get info fast and help the more seasoned with policy changes. > It's intended to provide a starting point for people who want to get > involved in development, as well as an index of relevant > information for > active developers. The table of contents should provide a good > overview of > its intended scope. > > I would appreciate feedback from developers about it, especially: > > - Existing resources which should be linked from it, or > incorporated into it Well, I don't really see any references to the Ubuntu Packaging Guide [0] . Also, would the Debian Python Policy be something to add? Maybe it's better for farther down the food chain. One thing I see on the page is a real mixture of Main and Universe and core dev and MOTU material. Here's an example: "Starting points" starts out with a reference to MOTU and then in the next section "Communication" it doesn't refer to #ubuntu-motu or ubuntu-motu ML at all. Some of the links are to MOTU/ wiki pages but are referenced as being general. I think we should either have a generic page (in perhaps a generic namespace) or 1 page for Universe and 1 page for Main. I think it would be nice to have 1 page and simply note where Main and Universe workflows diverge. This page is certainly a step in that direction and I'm glad to see it. Thanks for all the work Colin and Matt. - Jordan Mantha [0] Edgy version is https://help.ubuntu.com/6.10/ubuntu/ packagingguide/C/index.html and the "in progress" version (currently broken but should be fixed soon) http://doc.ubuntu.com/ubuntu/ packagingguide/C/index.html -- ubuntu-devel mailing list ubuntu-devellists.ubuntu.com Modify settings or unsubscribe at: https://lists.ubuntu.com/mailman/listinfo/ubuntu-devel
Re: New developer documentation
user name
2007-01-29 09:13:42
On Fri, Jan 26, 2007 at 09:27:39AM -0800, Jordan Mantha
wrote:
> On Jan 26, 2007, at 7:08 AM, Matt Zimmerman wrote:
> > I would appreciate feedback from developers about
it, especially:
> >
> > - Existing resources which should be linked from
it, or  
> > incorporated into it
> 
> Well, I don't really see any references to the Ubuntu
Packaging Guide  
> [0] .

Indeed, I wasn't even aware of that document until recently.
 Who wrote it,
and who has reviewed it for accuracy?

I've added it to a new section for resources which we
haven't incorporated
or referenced properly yet.

> Also, would the Debian Python Policy be something to
add?  
> Maybe it's better for farther down the food chain.

Likewise, I've added this to the todo list.

> One thing I see on the page is a real mixture of Main
and Universe  
> and core dev and MOTU material. Here's an example:

Agreed, this is something which needs improvement.  In
particular:

- The MOTU team has produced a substantial amount of
documentation, much of
  which is not specific to MOTU, but useful for developers
in general

- In some cases, there are both general developer and MOTU
versions of the
  same information; usually, one or the other is more
complete/accurate, and
  should supersede the other

- I don't think there is any such thing as documentation
which is *only*
  useful to core developers, and not to MOTU as well. 
However, we do have
  introductory material which is primarily useful for MOTU.

> "Starting points" starts out with a reference
to MOTU and then in the  
> next section "Communication" it doesn't refer
to #ubuntu-motu or  
> ubuntu-motu ML at all.

Those resources are prominent on the MOTU page, however.  I
do not want to
give the impression that MOTU should limit their involvement
to
MOTU-specific channels and lists, as was my worry when they
were first
introduced.

It's useful to have separate discussion areas for MOTU so
that they can be
used for intra-team coordination, Q&A, etc., but general
developer talk
should be in one place for all developers.

i.e., MOTU should also participate in ubuntu-devellists and
#ubuntu-devel!
I'm CCing ubuntu-motulists in case this is not quite how it
works yet. 

> Some of the links are to MOTU/ wiki pages but are
referenced as being  
> general. I think we should either have a generic page
(in perhaps a  
> generic namespace) or  1 page for Universe and 1 page
for Main. I  
> think it would be nice to have 1 page and simply note
where Main and  
> Universe workflows diverge. This page is certainly a
step in that  
> direction and I'm glad to see it.

That is my intention, yes.  It doesn't yet index all of the
MOTU resources
(and there's an XXX about that).  I'd appreciate some help
from MOTU folks
who know what's there and can advise us about how to best
incorporate them.

-- 
 - mdz

-- 
ubuntu-devel mailing list
ubuntu-devellists.ubuntu.com
Modify settings or unsubscribe at: https://lists.ubuntu.com/mailman/listinfo/ubuntu-devel


[1-2]

about | contact  Other archives ( Real Estate discussion Medical topics )