LWN.net Logo

Documented?

Documented?

Posted Nov 11, 2009 20:37 UTC (Wed) by tuna (guest, #44480)
In reply to: Documented? by djao
Parent article: GNOME 3.0 in September 2010

You are accusing the gnome developers of being actively hostile to documentation patches. Do you have any sources or examples to back this up?


(Log in to post comments)

Documented?

Posted Nov 11, 2009 21:47 UTC (Wed) by djao (subscriber, #4263) [Link]

Of course, although this thread is getting quite long already. The example is the same example that started this whole thread. The change to reduce the description of the gtk-key-theme option was certainly either introduced or approved by a GNOME developer, and this action is hostile and actively detrimental to improving the documentation.

Even if the change is technically "correct" as per the grandparent post (which I do not agree that it is), there are many natural ways to improve correctness without reducing specificity. It takes an actively destructive mindset to apply the fix that was actually applied.

Documented?

Posted Nov 12, 2009 2:25 UTC (Thu) by rahulsundaram (subscriber, #21946) [Link]

I think it is better to assume goodwill and send a documentation patch than complain about perceived hostility.

Documented?

Posted Nov 12, 2009 4:04 UTC (Thu) by djao (subscriber, #4263) [Link]

I already raised this issue rhetorically earlier in the thread. What possible patch can anyone send? The necessary code is already in their svn/git repository. Just revert to a previous version.

Documented?

Posted Nov 12, 2009 15:09 UTC (Thu) by rahulsundaram (subscriber, #21946) [Link]

A patch can very well revert a setting and the important part is to initiate a discussion in the GNOME development forums. The key is to assume good will.

Documented?

Posted Nov 12, 2009 16:15 UTC (Thu) by djao (subscriber, #4263) [Link]

It seems a discussion has already been initiated, at least: https://bugzilla.gnome.org/show_bug.cgi?id=558198

As I assumed, there was no movement on the issue. However, if you insist, I will go there and raise the issue more forcefully, in a little while, after I get my work done.

Copyright © 2012, Eklektix, Inc.
Comments and public postings are copyrighted by their creators.
Linux is a registered trademark of Linus Torvalds