Re: Where should these docs go?

[Gregory Leblanc <gleblanc linuxweasel com>]

On Thu, 2002-08-29 at 21:48, Eric Baudais wrote:
> On Thu, 2002-08-29 at 23:41, Malcolm Tredinnick wrote:
> > On Thu, Aug 29, 2002 at 11:35:26PM -0500, Eric Baudais wrote:
> > > > > On Thu, Aug 29, 2002 at 08:43:00PM -0600, John Fleck wrote:
> > > > > > On Thu, 2002-08-29 at 10:01, hobbit aloss ukuu org uk wrote:
> > > > > [...]
> > > > > > > I'm inclined to stuff 'em in gnome-docu/ but if people have
> > > > > > > thoughts on better places, now is a very good time to say.
> > > > > > 
> > > > > > That sounds like a good location to me. It's rather of a junk pile in
> > > > > > there right now, though, and the cleanest thing might be an entirely new
> > > > > > subdirectory: gnome-docu/gnome2-global-docs or some such. Then each
> > > > > > could get its own subdirectory, to whit:
> > > > > > 
> > > > > > gnome-docu/gnome2-global-docs/g2portability/C/g2portability.xml or some
> > > > > > such.
> > > 
> > > I disagree.  I think the docs should go to gnome-docu/gdp/contrib/. 
> > > This is supposed to be a staging area for documentation.  Any related
> > > user documentation should be placed into gnome-user-docs.  When a couple
> > > docs are written for developer documentation we should create a new
> > > module gnome-developer-docs which will package the developer docs.
> > 
> > Why do they need to be "staged"? Since a lot of the documents Telsa is talking
> > about are brand new, I agree with her idea of finding the right place for them
> > and putting them there initially.
> 
> I guess I did not fully explain my idea.  All the user documentation
> from Telsa's list should be placed into gnome-user-docs permanently.

When we originally created gnome-user-docs and gnome-devel-docs, the
intent was to keep these modules for docs that were ready for
distribution.  If we have somebody who's actually committed to writing
one of these docs, and we've got faith that they're at least going to
finish an initial version, even if they don't end up maintaining it,
then I'm all for putting these docs in gnome-user-docs.  If we think we
might end up with half of a doc, then I'd just as soon put this stuff in
gnome-docu, along with all of our other cruft.

> For developer documentation we should create a new module similar to
> gnome-user-docs where the developer documentation will be placed.  For
> the interm any developer documentation will go to contrib until the
> module gnome-developer-docs is created.

It's already been created.  gnome-devel-docs.  Right now it's got Dan's
"Joining GNOME" doc, and a session management tutorial by Federico and
Havoc.  No need for a new one, as far as I can see.  
	Greg

-- 
Gregory Leblanc <gleblanc linuxweasel com>