diff options
Diffstat (limited to 'zarb-ml/mageia-discuss/20101026/002658.html')
| -rw-r--r-- | zarb-ml/mageia-discuss/20101026/002658.html | 149 |
1 files changed, 149 insertions, 0 deletions
diff --git a/zarb-ml/mageia-discuss/20101026/002658.html b/zarb-ml/mageia-discuss/20101026/002658.html new file mode 100644 index 000000000..c6caace74 --- /dev/null +++ b/zarb-ml/mageia-discuss/20101026/002658.html @@ -0,0 +1,149 @@ +<!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=%3C1288049754.4401.35.camel%40akroma.ephaone.org%3E"> + <META NAME="robots" CONTENT="index,nofollow"> + <META http-equiv="Content-Type" content="text/html; charset=us-ascii"> + <LINK REL="Previous" HREF="002657.html"> + <LINK REL="Next" HREF="002660.html"> + </HEAD> + <BODY BGCOLOR="#ffffff"> + <H1>[Mageia-discuss] Suggestions</H1> + <B>Michael Scherer</B> + <A HREF="mailto:mageia-discuss%40mageia.org?Subject=Re%3A%20%5BMageia-discuss%5D%20Suggestions&In-Reply-To=%3C1288049754.4401.35.camel%40akroma.ephaone.org%3E" + TITLE="[Mageia-discuss] Suggestions">misc at zarb.org + </A><BR> + <I>Tue Oct 26 01:35:54 CEST 2010</I> + <P><UL> + <LI>Previous message: <A HREF="002657.html">[Mageia-discuss] Seperate log-files for each part of Mageia? +</A></li> + <LI>Next message: <A HREF="002660.html">[Mageia-discuss] Suggestions +</A></li> + <LI> <B>Messages sorted by:</B> + <a href="date.html#2658">[ date ]</a> + <a href="thread.html#2658">[ thread ]</a> + <a href="subject.html#2658">[ subject ]</a> + <a href="author.html#2658">[ author ]</a> + </LI> + </UL> + <HR> +<!--beginarticle--> +<PRE>Le lundi 25 octobre 2010 à 17:56 -0400, andre999 a écrit : +><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 require +</I>><i> a level of technical +</I>><i> expertise that surpasses the average user. +</I>><i> For documentation, the problem, and its solution, are generally obvious +</I>><i> to an average user who understands the language in question. +</I> +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 +( <A HREF="https://qa.mandriva.com/enter_bug.cgi?product=Mandriva%">https://qa.mandriva.com/enter_bug.cgi?product=Mandriva%</A> +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. + +-- +Michael Scherer + +</PRE> + + + +<!--endarticle--> + <HR> + <P><UL> + <!--threads--> + <LI>Previous message: <A HREF="002657.html">[Mageia-discuss] Seperate log-files for each part of Mageia? +</A></li> + <LI>Next message: <A HREF="002660.html">[Mageia-discuss] Suggestions +</A></li> + <LI> <B>Messages sorted by:</B> + <a href="date.html#2658">[ date ]</a> + <a href="thread.html#2658">[ thread ]</a> + <a href="subject.html#2658">[ subject ]</a> + <a href="author.html#2658">[ 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> |