Re: user docs release?

[John Fleck <jfleck inkstain net>]

On Tue, 2002-06-11 at 13:49, Chris Lyttle wrote:
> The Sun version of the Users Guide for GNOME2 is currently in the module, 
> also it is the only thing setup to build atm. I'd vote for a) too, I can 
> do a quick conversion of the existing docs to xml format without changing the 
> content and update the OMF files. This will depend on how John Fleck feels 
> about it tho, he may just prefer to go with b) due to the closeness of 
> release. Thanks for the update, Sasha
> 
> Chris
> 
> On 11 Jun 2002, Alexander Kirillov wrote:
> 
> > The problem is, none of the stuff in gnome-user-docs was  updated for
> > 2.0. The Users Guide is being rewritten by Sun guys;  afaik, a version
> > of Sun's UG  for 1.4 is ready (it is not the same as waht we used for
> > 1.4) but  updating it for 2.0  is not complete yet. Other docs (intro to
> > gnome, unix-primer, glossary) were not updated at all - this is mostly
> > my fault, as I was maintaining them. But I am afraid I can't really
> > maintain them at the moment - for various personal reasons. 
> > 
> > Unix-primer actually needs no updating (other than sgml->xml conversion)
> > and I think it is still relevant, so it should probably be included. As
> > for other docs, unless someone volunteers to do a quick update, we have
> > a choice of 
> > 
> >  a. shipping 1.4 docs with GNOME 2.0 - and fix it by 2.01 release
> >  b. removing old docs and ship without them 
> > 
> > I'd probably vote for a. - but replacing the version of the UG we had
> > for 1.4 by Sun's UG, even if it is not fully updated for 2.0.
> > 

I think we need to do "b" - include the Sun Users Guide, which we have
to have for panel, nautilus, etc., and nothing else. None of the rest is
updated, and it's too close to release to mess with. We need to get this
out, then get it cleaned up for 2.0.1.

Jeff, Sander - I'd prefer is Sander did it. I'm not at all comfortable
with the auto* stuff. I'll be happy to take this over, but I'd rather
not have 2.0.0 be my first attempt.
Cheers,
John
-- 
John Fleck
jfleck inkstain net (h) jfleck abqjournal com (w)
http://www.inkstain.net http://www.abqjournal.com

"You don't want to die with the music still in you."
 - John Gardner