diff options
Diffstat (limited to 'zarb-ml/mageia-discuss/20101026/002655.html')
| -rw-r--r-- | zarb-ml/mageia-discuss/20101026/002655.html | 176 |
1 files changed, 176 insertions, 0 deletions
diff --git a/zarb-ml/mageia-discuss/20101026/002655.html b/zarb-ml/mageia-discuss/20101026/002655.html new file mode 100644 index 000000000..ddc5cda14 --- /dev/null +++ b/zarb-ml/mageia-discuss/20101026/002655.html @@ -0,0 +1,176 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN"> +<HTML> + <HEAD> + <TITLE> [Mageia-discuss] Suggestions + </TITLE> + <LINK REL="Index" HREF="index.html" > + <LINK REL="made" HREF="mailto:mageia-discuss%40mageia.org?Subject=Re%3A%20%5BMageia-discuss%5D%20Suggestions&In-Reply-To=%3C4CC5FE3C.7090501%40laposte.net%3E"> + <META NAME="robots" CONTENT="index,nofollow"> + <META http-equiv="Content-Type" content="text/html; charset=us-ascii"> + + <LINK REL="Next" HREF="002656.html"> + </HEAD> + <BODY BGCOLOR="#ffffff"> + <H1>[Mageia-discuss] Suggestions</H1> + <B>andre999</B> + <A HREF="mailto:mageia-discuss%40mageia.org?Subject=Re%3A%20%5BMageia-discuss%5D%20Suggestions&In-Reply-To=%3C4CC5FE3C.7090501%40laposte.net%3E" + TITLE="[Mageia-discuss] Suggestions">andr55 at laposte.net + </A><BR> + <I>Tue Oct 26 00:01:32 CEST 2010</I> + <P><UL> + + <LI>Next message: <A HREF="002656.html">[Mageia-discuss] Suggestions +</A></li> + <LI> <B>Messages sorted by:</B> + <a href="date.html#2655">[ date ]</a> + <a href="thread.html#2655">[ thread ]</a> + <a href="subject.html#2655">[ subject ]</a> + <a href="author.html#2655">[ author ]</a> + </LI> + </UL> + <HR> +<!--beginarticle--> +<PRE>andre999 a écrit : +><i> +</I>><i> Wolfgang Bornath a écrit : +</I>>><i> +</I>><i> +</I>>><i> 2010/10/25 Wayne Sallee <<A HREF="https://www.mageia.org/mailman/listinfo/mageia-discuss">Wayne at waynesallee.com</A>>: +</I>><i> +</I>>><i> > Wolfgang Bornath wrote on 10/25/2010 12:24 PM: +</I>><i> +</I>>><i> >> +</I>><i> +</I>>><i> >> I don't think it would help. There is (was) the tag "Doc" +</I>><i> (or +</I>><i> +</I>>><i> >> similar) in Bugzilla which already marked the bug as +</I>><i> something +</I>><i> +</I>>><i> >> related to documentation. Somebody who is concerned and +</I>><i> ignored +</I>><i> +</I>>><i> >> that would also ignore a separate section and vice versa. +</I>><i> I like +</I>><i> +</I>>><i> >> a more general approach involving the users and packagers +</I>><i> +</I>>><i> >> likewise: +</I>><i> +</I>>><i> > +</I>><i> +</I>>><i> > Yea I think that having it all in the same bugzilla is best, +</I>><i> though +</I>><i> +</I>>><i> > most newbees are not going to think of posting the issue in a +</I>><i> bug +</I>><i> +</I>>><i> > report. Most newbees are going to think that bug reports are +</I>><i> for +</I>><i> +</I>>><i> > the software not working right. So I think we need to somehow +</I>><i> let +</I>><i> +</I>>><i> > the newbees know that bugzilla is the place to report +</I>><i> improvements +</I>><i> +</I>>><i> > needed in rpm documentation. +</I>><i> +</I>>><i> +</I>><i> +</I>>><i> That's where the part is coming in which you cut from the quote of +</I>><i> my +</I>><i> +</I>>><i> mail :) +</I>><i> +</I>><i> What about "docuzilla", a place to treat documentation ? +</I>><i> +</I>><i> There is a fundamental difference between software bugs, and +</I>><i> documentation considerations. +</I>><i> Software bugs often do not have an obvious cause, and generally +</I>><i> require a level of technical +</I>><i> expertise that surpasses the average user. +</I>><i> For documentation, the problem, and its solution, are generally +</I>><i> obvious to an average user who understands +</I>><i> the language in question. +</I>><i> There is the problem, for the package description, of knowing what the +</I>><i> program does, but although +</I>><i> the developers can give a technical description, this often has to be +</I>><i> reworked to be in a form +</I>><i> the average non-technical user can understand. +</I>><i> +</I>><i> 1) Documentation and text displayed in programs have to be localised. +</I>><i> Program logic does not. +</I>><i> (At least, beyond doing internationised coding.) +</I>><i> +</I>><i> 2) Documentation has to be presented in a manner that non-technical +</I>><i> users can understand. +</I>><i> Program logic has to be presented in a manner that technical people +</I>><i> can follow. +</I>><i> +</I>><i> 3) Problems with documentation is generally best corrected by +</I>><i> non-technical users. +</I>><i> Program logic is the domain of technical specialists. +</I>><i> +</I>><i> 4) Documentation is best developed and corrected together, in +</I>><i> essentially the same process. +</I>><i> Program development and debugging are different processes, although +</I>><i> they can involve the +</I>><i> same people. +</I>><i> +</I>><i> Bugzilla could be used for both types of problems. Maybe just +</I>><i> separating the input and +</I>><i> correction interfaces would suffice, but it seems to me that we +</I>><i> really need to take a +</I>><i> different approach to the 2 types of problems. +</I>><i> +</I>><i> Here we are all technical people (not necessarily developers), and we +</I>><i> have no problem with bug +</I>><i> reports, etc. +</I>><i> But many documenters and translaters are essentially non-technical, +</I>><i> and they should have a good +</I>><i> sense of presentation to non-technical users in order to make credible +</I>><i> contributions. +</I>><i> And when they contribute corrections, they have no need of the +</I>><i> formalised process of bugzilla. +</I>><i> A correction is generally a quick glance, verify the context, and it's +</I>><i> done. +</I>><i> +</I>><i> Whence my proposal for a separate section of bugzilla. More +</I>><i> accessible for non-technical users, +</I>><i> who thus risque to contribute more actively to Mageia. +</I>><i> +</I>><i> But if anyone has a better idea ... +</I>><i> +</I>><i> Another 2 cents :) +</I>><i> +</I>><i> - André +</I> +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é + +</PRE> + + +<!--endarticle--> + <HR> + <P><UL> + <!--threads--> + + <LI>Next message: <A HREF="002656.html">[Mageia-discuss] Suggestions +</A></li> + <LI> <B>Messages sorted by:</B> + <a href="date.html#2655">[ date ]</a> + <a href="thread.html#2655">[ thread ]</a> + <a href="subject.html#2655">[ subject ]</a> + <a href="author.html#2655">[ author ]</a> + </LI> + </UL> + +<hr> +<a href="https://www.mageia.org/mailman/listinfo/mageia-discuss">More information about the Mageia-discuss +mailing list</a><br> +</body></html> |