GNOME Bugzilla – Bug 91866
Needed: Developer FAQ
Last modified: 2005-01-15 17:23:37 UTC
Gnome needs a developers FAQ. This is a massive undertaking. I have a structure drafted bu have done little else. From email notes about this: * Gnome 2.0 Developer FAQ. Easily achieved: just monitor desktop-devel-list, gnome-devel-list, gnome-love and IRC. Well, for the questions. Answers are harder. This is where I stalled last time, although I think I have my list of questions from 1.x days knocking around still. I have far too much crud here. I will send more about this: if we can block out the questions, we can get other people to provide the answers. Should also cover where Gnome stops and X starts. And how to debug. Link to a profiling doc should go in too. And _much_ reference material: freedesktop.org, jwz's "how x selection works" thing (see http://www.linux.org.uk/~telsa/GDP/index.html for links to that and for "how to i18n-ise your app to multibyte languages) Don't just paste half of gtk faq in: post a link. less updating for the maintainer then.
I quickly wrote some faq to help new developers to get involved, it's available at http://cfergeau.free.fr/new-gnome-devel-FAQ. This is orthogonal to the technical faq you are describing, but is also needed imo. It's quite incomplete, and need to be rewritten in proper english. If that's of interest, I can work more on it (that reminds me that I must have a docbook version of that somewhere)
This is brilliant. I wonder whether it should get incorporated into Dan Mueth's "getting involved" document? Immediately, I mean. Whilst we finish a devel-faq properly.
I put the docbook version at http://cfergeau.free.fr/new-gnome-devel-FAQ.xml To make things clear, anyone is free to grab this document, make corrections to it, add questions, ... and put it online on gnome.org or whereever it is appropriate
> I wonder whether it should get incorporated into > Dan Mueth's "getting involved" document? Telsa, do you have a URL for this? > I put the docbook version at > http://cfergeau.free.fr/new-gnome-devel-FAQ.xml I'd say go for it. To encourage self-maintenance of the FAQ I have found that it helps to add, on the same page: - Its path in cvs, with a link to cvs.gnome.org/lxr/source/... - A link to bugzilla, where they can at least suggest changes: http://bugzilla.gnome.org/enter_bug.cgi?product=website
*** Bug 91478 has been marked as a duplicate of this bug. ***
Maybe Elijah's development guide does what was wanted here? Except referencing external material etc maybe?
Wow, this bug is still open? I think with Elijah's stuff available and widely-known about (I hope!), it can be closed. For people who find the bug and haven't seen Elijah's doc: http://www.gnome.org/~newren/tutorials/developing-with-gnome/