Re: user docs release?

["Eugene O'Connor" <Eugene Oconnor Sun COM>]

In the temporary Doctable (http://developer.gnome.org/projects/gdp/doctable--.html), 
Sun are down to do the GNOME 2.0 User Guide, including the panel, nautilus, and 
control center information. As you can see from the Doctable, we have completed 
these tasks and built the documentation. If there are any updates required to these 
documents, let me know and I will do the updates.

At the end of May, we put back a fully-working 2.0 level user guide. In Sun we have 
successfully built all of the Sun-supplied documentation, and can view it in Yelp. 
So I'm concerned at talk of shipping with 1.4 docs when the 2.0 docs are updated, 
ready, and available.

To find out if you have the latest 2.0 User Guide, try the following:

- Do you see the 11 chapters of the user guide that are currently available when 
you select Help - Applications, and click on Core Desktop? These are all 2.0 
level. 

- If you click on specific chapters such as "Basic Skills" in Yelp, can you open 
the chapter and read the contents? 

- Can you open the relevant user-guide Help from the Help menu of desktop level 
components, such as on the panel. Right-click on a panel and select Panel 
Manual. If Yelp opens, you should be able to go to the About This Document page 
to see if Sun is the contributor for this information. 

If you are not seeing these things, then there are problems that should be 
fixed. We are seeing all of these things, but if only Sun has successfully 
implemented the 2.0 user guide as user documentation and desktop help, then we 
need to know about it, and see if we can do something to help. 

Eugene

>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
>
>_______________________________________________
>gnome-doc-list mailing list
>gnome-doc-list gnome org
>http://mail.gnome.org/mailman/listinfo/gnome-doc-list