scribe.html
7.58 KB
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
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<title>Scribe 101</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<link rel="stylesheet" href="/StyleSheets/generic-base-1.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="/Guide/guide2006.css" />
</head>
<body>
<div class="head">
<div id="header">
<span class="logo"><a href="/"><img src="/Icons/WWW/w3c_home_nb" alt="W3C" height="48" width="72" /></a></span>
<div class="breadcrumb">
<a href="/Member/">Member</a> → <a href="/Guide/">The Art of Consensus</a> →
<h1>Scribe 101</h1>
</div>
<p class="baseline">This <strong>Guidebook</strong> is the collected wisdom of the W3C Group Chairs and other collaborators.</p>
</div>
<div class="toc">
<h4>Also On This Page → </h4>
<ul>
<li><a href='#use'>Use of IRC</a> • </li>
<li><a href='#beginning'>At the beginning of the call</a> • </li>
<li><a href='#during'>During the call</a> • </li>
<li><a href='#after'>After the call</a> • </li>
</ul>
</div>
<div class="toolbox box" style="margin-bottom: 1em">
<h4>Nearby</h4>
<ul>
<li><a href="/Project/IRC/">Internet Relay Chat (IRC)</a></li>
<li><a href="/2002/03/RRSAgent">RRSAgent</a></li>
<li><a href="/2001/12/zakim-irc-bot.html">Zakim</a></li>
<li><a href='/2005/06/tracker/irc'>Trackbot</a></li>
<li><a href='http://dev.w3.org/2002/scribe/scribedoc.htm'>Generate Meeting Minutes</a></li>
</ul>
</div>
</div>
<p>Some of you who may not be familiar with the way that minutes are
recorded for W3C meetings might benefit from a bit of a primer/FAQ for
scribes.</p>
<h2 id='use'>Use of IRC</h2>
<p>Use of IRC is preferred for scribing since the clean-up and
preparation of the final minutes can be fairly automated using the
various IRC bots, etc. Please let the chairs know if you will be
unable to scribe from IRC before the meeting in which you are likely
to be selected (e.g. you are atop the scribes list).</p>
<h2 id='beginning'>At the beginning of the call</h2>
<p>Ensure that the call is setup by issuing the following command:</p>
<ul class='command'>
<li>trackbot-ng, start telcon</li>
</ul>
<p>Trackbot-ng will invite the other bots for you and setup the access
controls. You then need to identify yourself to Zakim as the
scribe:</p>
<ul class='command'>
<li>scribe: joe</li>
</ul>
<p>or</p>
<ul class='command'>
<li>scribeNick: joe</li>
</ul>
<p>You should also identify the chair:</p>
<ul class='command'>
<li>chair: edouard</li>
</ul>
<p>It is also good practice to add a link to the agenda:</p>
<ul class='command'>
<li>agenda: <link to the agenda></li>
</ul>
<h2 id='during'>During the call</h2>
<h3>Identify the agenda topic being discussed</h3>
<ul class='command'>
<li>TOPIC: review of action items</li>
</ul>
<h3>What should be recorded?</h3>
<p>W3C minutes should record the sense of all of the discussion held.
This may be different than what some are accustomed to (e.g. some
other organizations simply record action items and resolutions).
Thus, when a topic is being discussed, the scribe should capture the
sense (no need to try to get every word)</p>
<ul class='command'>
<li>joe: doesn't like the proposal because it is too vague</li>
</ul>
<p>Note that the person's name is recorded as <code><name>:</code></p>
<p>If the scribe is unsure of whom is speaking, then they should
record in the minutes:</p>
<ul class='command'>
<li>??: doesn't like the proposal because it is too vague</li>
</ul>
<p>Someone will hopefully fix this in IRC using a sed command:</p>
<ul class='command'>
<li>s/??/joe/</li>
</ul>
<p>otherwise, when reviewing the minutes, the speaker should recognize
that it was they who made the point and they should ask the chairs to amend the
minutes to reflect that fact. If they do not, then at least the point is
recorded (even though no one will ever know who made the point).</p>
<p>Note that if someone makes a specific proposal, then every effort
should be made by the scribe to capture it fully and accurately in the
minutes. It would be unfortunate if all that were recorded was:
<q>joe: makes a proposal for resolving issue-NNNN</q></p>
<h3>Action Items</h3>
<p>When recording action items, the form should be as follows:</p>
<ul class='command'>
<li>ACTION: <name> to <do something> [due
<when>]</li>
</ul>
<p>When recording a comment on an existing action item, the form should be as follows:</p>
<ul class='command'>
<li>trackbot-ng, comment action-2 something…</li>
</ul>
<p>You can also close action action items:</p>
<ul class='command'>
<li>close action-2</li>
</ul>
<p>As a good practice, always use the form <code>"ACTION-NNNN"</code>
when mentioning an existing action item in the record. This syntax
will be picked up by the email tracker later.</p>
<h3>Issues</h3>
<p>As for actions, always use the form <code>"ISSUE-NNNN"</code> when
mentioning an existing issue in the record. This syntax will be picked
up by the email tracker later. Note that you cannot create or close
issues using IRC commands.</p>
<h3>Resolutions</h3>
<p>When recording a resolution, the form should be as follows:</p>
<ul class='command'>
<li>RESOLUTION: issue-2 yadda yadda yadda</li>
</ul>
<p>or, if the resolution isn't related to an issue:</p>
<ul class='command'>
<li>RESOLUTION: yadda yadda yadda</li>
</ul>
<!--
<p>Also, it is useful to mark the location of all resolutions, since
they are only styled for color. To do this, enter the following command in IRC:</p>
<ul class='command'>
<li>rrsagent, where am I?</li>
</ul>
-->
<h3 id='mistake'>Making/fixing mistakes</h3>
<p>When you make a mistake/typo in recording something, you can use
sed
commands
to add corrections to the log:</p>
<ul class='command'>
<li>s/teh/the/</li>
</ul>
<p>However, this doesn't work when the typo is with either of the
following
keywords: <em>ACTION</em> or <em>RESOLUTION</em>.</p>
<p>If the problem was that you mistyped the keyword <em>ACTION</em> or
<em>RESOLUTION</em>,
then simply enter the <em>ACTION</em> or <em>RESOLUTION</em> again, fixing the
mistake.</p>
<p>If, however, the ACTION or RESOLUTION was incorrectly recorded,
then these
need to be
fixed using the form:</p>
<ul class='command'>
<li>ACTION-<number> = <replacement text></li>
</ul>
<p>The two syntaxes above are unfortunately not being picked up by
trackbot-ng, thus one has to go to the Web interface later on and fix
the title of the action item.</p>
<h2 id='after'>After the call</h2>
<p>Ask rrsagent to generate the minutes:</p>
<ul class='command'>
<li>rrsagent, generate minutes</li>
</ul>
<p>RRSAgent will reply by providing the link to the generated record.</p>
<p>If you find any mistake, fix them using <a
href='#mistake'>Making/fixing mistakes</a>. You can then ask RRSAgent to
regenerate the record as many times as you need, as long as it's within the same day.</p>
<p><strong>Once the record has been approved by the Group</strong>, send a <em>text
version</em> of the record to the Group list. trackbot-ng will pick
them up and associate actions and issues with the record. You can use
the comma tool <code>,text</code> to generate a text version of the
generated record:</p>
<pre>
http://www.w3.org/2008/04/02-sml-minutes.html,text
</pre>
<hr />
<address><a href='mailto:plh@w3.org'>plh@w3.org</a></address>
</body>
</html>