[Mageia-discuss] Suggestions
andre999
andr55 at laposte.net
Tue Oct 26 00:01:32 CEST 2010
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"
> (or
>
>> >> similar) in Bugzilla which already marked the bug as
> something
>
>> >> related to documentation. Somebody who is concerned and
> ignored
>
>> >> 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,
> though
>
>> > most newbees are not going to think of posting the issue in a
> bug
>
>> > report. Most newbees are going to think that bug reports are
> for
>
>> > the software not working right. So I think we need to somehow
> let
>
>> > the newbees know that bugzilla is the place to report
> improvements
>
>> > needed in rpm documentation.
>
>>
>
>> That's where the part is coming in which you cut from the quote of
> my
>
>> 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.
> There is the problem, for the package description, of knowing what the
> program does, but although
> the developers can give a technical description, this often has to be
> reworked to be in a form
> the average non-technical user can understand.
>
> 1) Documentation and text displayed in programs have to be localised.
> Program logic does not.
> (At least, beyond doing internationised coding.)
>
> 2) Documentation has to be presented in a manner that non-technical
> users can understand.
> Program logic has to be presented in a manner that technical people
> can follow.
>
> 3) Problems with documentation is generally best corrected by
> non-technical users.
> Program logic is the domain of technical specialists.
>
> 4) Documentation is best developed and corrected together, in
> essentially the same process.
> Program development and debugging are different processes, although
> they can involve the
> same people.
>
> Bugzilla could be used for both types of problems. Maybe just
> separating the input and
> correction interfaces would suffice, but it seems to me that we
> really need to take a
> different approach to the 2 types of problems.
>
> Here we are all technical people (not necessarily developers), and we
> have no problem with bug
> reports, etc.
> But many documenters and translaters are essentially non-technical,
> and they should have a good
> sense of presentation to non-technical users in order to make credible
> contributions.
> And when they contribute corrections, they have no need of the
> formalised process of bugzilla.
> A correction is generally a quick glance, verify the context, and it's
> done.
>
> Whence my proposal for a separate section of bugzilla. More
> accessible for non-technical users,
> who thus risque to contribute more actively to Mageia.
>
> But if anyone has a better idea ...
>
> Another 2 cents :)
>
> - André
BTW, just think of our interactions, at least wobo and myself, with
those in the marketing group.
A different focus can require a different approach ... :)
- André
More information about the Mageia-discuss
mailing list