On Mon, 2009-08-17 at 11:41 -0800, Christopher Howard wrote:

> So, two main questions here: first, what is the working philosophy
> around here about code comments? Are we preferring more of a "well
> written code should explain itself" approach?

Exactly. But comments are of course welcome.

> Are we inclined to accept
> patch submissions that simply add comments to code? Are there guidelines
> for what code comments should be like?

Of course patches that add comments are appreciated and we have accepted
such patches in the past. Comments should be in gtk-doc syntax, so that
they end up in the API reference manual.

> Second, if new developers can't figure out what a piece of code does, or
> where some functionality is, should we ask on this list? (That's
> actually not a hypothetical question in my case...)

Sure. This is the right place to ask.


Gimp-developer mailing list

Reply via email to