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
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
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>
|
