public inbox for gentoo-dev@lists.gentoo.org
 help / color / mirror / Atom feed
Search results ordered by [date|relevance]  view[summary|nested|Atom feed]
thread overview below | download: 
* Re: [gentoo-dev] [RFC] Features and documentation
  @ 2007-11-29  2:25 99%         ` Alec Warner
  0 siblings, 0 replies; 1+ results
From: Alec Warner @ 2007-11-29  2:25 UTC (permalink / raw
  To: gentoo-dev

On 11/28/07, Donnie Berkholz <dberkholz@gentoo.org> wrote:
> On 16:43 Wed 28 Nov     , Alec Warner wrote:
> > On 11/28/07, Donnie Berkholz <dberkholz@gentoo.org> wrote:
> > > Here's my understanding of what you said: Because people will break
> > > rules and violate standards, we shouldn't have any.
> > >
> > > Is that accurate?
> > >
> >
> > Kind of.
> >
> > Most people follow most rules.  Most people break a subset of rules.
> >
> > You are essentially adding an unreasonable (in my view) rule that I
> > expect nearly everyone to break or ignore, thereby adding little or no
> > value to the project as whole.  Most people care about documentation
> > in the abstract sense, almost no one cares *enough* to write any ;)
> >
> > Forcing people to write documentation won't get it written, people
> > will continue to act like we just saw and either the rule will get
> > ignored, or someone will change the rule, or people will leave because
> > the rule is enforced aggressively and it has ruined the ability to
> > contribute to the project.
>
> The Linux kernel seems to still have contributors, despite its
> requirement. It seems like people decide to leave after nearly any
> change Gentoo makes these days, so I'm not even sure how much we should
> consider that unless we want to stop all development and do nothing.
> (But I guess that also would be a change, so people would quit.)
>
> > This is why I offered to write the GLEP for Diego and Cardoe, because
> > I know they are not interested in writing it themselves.  Thats why we
> > have a doc-team that for some sick reason enjoy writing and
> > maintaining documentation.
>
> You've made some great points here about working with people who enjoy
> dealing with docs. What I'm saying is that we should work with these
> people before committing rather than after.
>

I can get behind that then ;)

> Thanks,
> Donnie
> --
> gentoo-dev@gentoo.org mailing list
>
>
-- 
gentoo-dev@gentoo.org mailing list



^ permalink raw reply	[relevance 99%]

Results 1-1 of 1 | reverse | options above
-- pct% links below jump to the message on this page, permalinks otherwise --
2007-11-27 19:21     [gentoo-dev] [RFC] Features and documentation Donnie Berkholz
2007-11-28  3:10     ` Alec Warner
2007-11-28 21:15       ` Donnie Berkholz
2007-11-29  0:43         ` Alec Warner
2007-11-29  1:01           ` Donnie Berkholz
2007-11-29  2:25 99%         ` Alec Warner

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox