1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
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>
|
