Gentoo Archives: gentoo-dev

From: Duncan <1i5t5.duncan@×××.net>
To: gentoo-dev@l.g.o
Subject: [gentoo-dev] Re: [RFC] Features and documentation
Date: Fri, 30 Nov 2007 17:47:25
In Reply to: [gentoo-dev] Re: [RFC] Features and documentation by Steve Long
1 Steve Long <slong@××××××××××××××××××.uk> posted fiop46$9o$1@×××××××××.org,
2 excerpted below, on Fri, 30 Nov 2007 10:42:03 +0000:
4 > Duncan wrote:
6 >> It's kinda hard to discuss such a proposal without knowing where it is
7 >> going to be applied
9 > I took it to mean anything which changes something already documented on
10 > a gentoo doc website (including the devmanual but not individual dev
11 > space) or in a man page. [...] Additions would count too; I'd imagine
12 > someone adding a new feature would want others to know about it.
14 > I saw [this] as an attempt to make the development team aware of
15 > documentation responsibility, and asking them to bear that in mind when
16 > they change or add stuff [...] It doesn't have to mean sanctions at any
17 > point, but rather that someone would be put in touch with docs if they
18 > needed help to document stuff. I'd think new people would welcome that.
20 OK. That makes sense, and the last part agrees with the reply I got from
21 the private inquiry I mentioned. Quoting a single though from Donnie's
22 reply:
24 > This isn't about punishing people. But it could be about
25 > reverting their commit until it comes back with documentation.
27 IMO people are (unfortunately correctly, given history) afraid of
28 something being used to clobber them over the head. If the above thought
29 were included virtually verbatim in whatever is ultimately hard-proposed,
30 I believe it'd go a LONG way to avoiding that, since the "clobber limits"
31 are now clearly defined and (IMO) reasonable.
33 I guess I've been concerned that neither the reach of nor the weight of
34 the "clobber stick" seemed limited in any way, and I think we've seen
35 that an unlimited "clobber stick" isn't a good thing. I was trying to
36 limit the reach; Donnie didn't want that, but now I see his point that
37 limiting the weight is equally abuse preventative, while less crippling
38 to the effectiveness of the tool.
40 So provided a substantively similar "clobber limit" appears in the final
41 proposal, I'm now supportive.
43 --
44 Duncan - List replies preferred. No HTML msgs.
45 "Every nonfree program has a lord, a master --
46 and if you use the program, he is your master." Richard Stallman
48 --
49 gentoo-dev@g.o mailing list