misc at zarb.org
Tue Oct 26 01:35:54 CEST 2010
Le lundi 25 octobre 2010 à 17:56 -0400, andre999 a écrit :
> Wolfgang Bornath a écrit :
> > 2010/10/25 Wayne Sallee <Wayne at waynesallee.com>:
> > > Wolfgang Bornath wrote on 10/25/2010 12:24 PM:
> > >>
> > >> I don't think it would help. There is (was) the tag "Doc"
> > >> similar) in Bugzilla which already marked the bug as
> > >> related to documentation. Somebody who is concerned and
> > >> that would also ignore a separate section and vice versa.
> I like
> > >> a more general approach involving the users and packagers
> > >> likewise:
> > >
> > > Yea I think that having it all in the same bugzilla is best,
> > > most newbees are not going to think of posting the issue in a
> > > report. Most newbees are going to think that bug reports are
> > > the software not working right. So I think we need to somehow
> > > the newbees know that bugzilla is the place to report
> > > needed in rpm documentation.
> > That's where the part is coming in which you cut from the quote of
> > mail :)
> What about "docuzilla", a place to treat documentation ?
> There is a fundamental difference between software bugs, and
> documentation considerations.
> Software bugs often do not have an obvious cause, and generally require
> a level of technical
> expertise that surpasses the average user.
> For documentation, the problem, and its solution, are generally obvious
> to an average user who understands the language in question.
I am sorry to tell that so abruptly, but I think this would be wrong :
1) this would create confusion. If a software do not act like
documented, is this a error of documentation or a error of the
software ? How do we expect people to decide ?
2) do you really think that having twice the cognitive load will better
for a regular user ? ( ie having to learn 1 system, then another for a
different class of problem )
3) do you really think that developers would like to have such
dispersion ? ( ie having to look at 2 place to find stuff to correct ? )
( in case there is 2 different system, of course )
And if we take the current bugzilla instance at mandriva
20Linux&format=guided ), what part would be changed for documentation of
rpm, ie what do you think that should be removed ?
The 2 only thing I can think of would be
"url" ( who is optional ) and mainly because I would also likely remove
it for regular software.
I would also remove the privacy option, because it somewhat irrelevant
with the current set of option for documentation, but I doubt this would
warrant a full change in the interface.
More information about the Mageia-discuss