Re: gnome-control-center and ximian-setup-tools docs

[Alexander Kirillov <kirillov math sunysb edu>]

Dear Aaron:
since I am maintaining the control-center docs at the moment, I'd like
to participate in this. 

Yes, I think your suggestion makes sense: have one manual that
describes shell and have each capplet provide its own help
file. Moreover, I can write much of it. But that's about all I can
do. I need someone to tell me where to put the docs, to do the
makefile magic (e.g.: in which directory should the docs for
"keyboard" capplet be placed?$prefix/gnome/help/keyboard-capplet? or
should we create a subdirectory "capplets"?). Most importantly, we
need developers to link help menu/buttons to the docs 
themselves. Unfortunately, in my experience sometimes it took
developers (such as Hovinen) long time to do things like this I asked
them about. So: I can write docs, but if you and mproper could take
care of everyting else, it'd be great.

Best,
Sasha
 

On Wed, Aug 08, 2001 at 07:15:57PM -0400, Aaron Weber wrote:
> Since the new version of the control center no longer uses embedded
> capplets we should probably decide what to do about the help files for
> individual capplets. (blah, I think that's your turf, so let me know
> what you think about this whole thing.)
> 
> IMHO we should have a help file for the shell that explains what it's
> for and how to get to the actual tools, and then individual capplets can
> have their own docs accessible from a "?" button or a Help menu.
> 
> That way we have easy and consistent UI when apps add additional
> capplets.  We can link to the docs for the more popular capplets from
> the base control center.
> 
> The ximian-setup-tools are in the process of becoming basically an extra
> set of capplets, and Kevin Breit (mrproper) and I will be working on the
> docs for those. I'd be more than happy to contribute additional work on
> the gnome-control-center docs.  Let's get the new versions the
> documentation they need to be totally polished.
> 
> Yours,
> Aaron Weber
> Ximian, Inc.
> 
> -- 
> "Neque porro quisquam est qui dolorem ipsum quia dolor sit amet,
> consectetur, adipisci velit . . ."  Cicero
> 
> 
> 
> _______________________________________________
> gnome-doc-list mailing list
> gnome-doc-list gnome org
> http://mail.gnome.org/mailman/listinfo/gnome-doc-list