Re: [gnome-love] No love for docs?

[Ross Golder <ross golder org>]

Kevin,

I know we now have a GNOME Foundation helping to steer things, but as
far as I can see, it's still just a large bunch of inter-operating open
source projects, mostly driven by the project developers (who'd rather
code than write docs!). As I see it, open source projects are grateful
for any contributions.

I'd suggest that you review the recent Foundation meeting minutes to see
if action has been planned for something you see as needs doing. If
nothing has been decided, or nobody has stepped up to do it, go ahead
and update project status tables or anything you see fit to update. Send
your updates to the appropriate mailing list(s)/project maintainers. I'm
sure they'd have updated it themselves, if they could only bring
themselves to stop coding for a moment :)

If you feel you want to determine interest in something you want to do,
discuss specific ideas by e-mail or on IRC (#gnome) with other GNOME
users/developers. I find, if something needs doing, just do it and let
people know you're doing it. If someone's already doing it, or it
shouldn't be done like that, you'll soon hear about it.

--
Ross, not really feeling like he's imparted anything that isn't already
general knowledge. :)

On Tue, 2002-01-22 at 01:44, Kevin Conder wrote:
>       I'm documentation writer fluent in the ways of DocBook. I've been
> looking for a way to contribute to the Gnome project. So far, I helped the
> programmer of the guikachu project when he posted a direct plea to the
> gnome-doc mailing list. I have much love to give...
>
>       However, it seems like you have to "know someone" to contribute to
> the Gnome Documentation Project. Their pages on developer.gnome.org are a
> mess. It doesn't look like their Documentation Status Table 
> (http://www.gnome.org/gdp/doctable/doctable.php3) is being kept 
> up-to-date. How can I contribute when I don't know what needs to be done
> and who's doing what?
>
>       The GTK+ Reference Documentation Project is an even worse. It
> looks like their status page (http://www.gtk.org/rdp/status.html) hasn't
> been updated since *late 1999*! I guess they want to keep the information
> a secret. 
>
>       What tags do I use to mark-up code for gtk-doc? What tools do I
> use to process marked-up code and where can I download them? I'd like to
> spread some documentation love to the GTK+ API but I don't know how.
>
>       Do you have to be a close personal friend to someone on the Gnome
> Foundation to write docs? Why do the documentation teams fail to document
> their own efforts? Makes no sense to me.
>
>
> -- Kevin Conder, kevin kevindumpscore com
>
> _______________________________________________
> gnome-love mailing list
> gnome-love gnome org
> http://mail.gnome.org/mailman/listinfo/gnome-love