Warning:
This wiki has been archived and is now read-only.

Scribe Instructions

From W3C eGovernment Wiki

Jump to: navigation, search

Before scribing

/invite Zakim
/invite RRSagent

/topic <URL of meeting agenda>

Zakim, this will be egov

Scribe: <scribe>

RRSAgent, make records public

This is a subset of all the features supported by Scribe.perl. This should probably be all the scribe needs to know.


Scribe Activity	IRC syntax	Example
Declare who is scribing	`Scribe: <irc nickname of scribe>`	`Scribe: alanr`
Recording what someone says	`<name>: <text of what they said>`	`Sandro: I don't think that's a good idea`
Shortcut for more from the same speaker	`... <additional text>`	`... because it will never work`
Correcting mistakes	`s/<old text>/<new text>/`	`s/it will/it would/`
Assigning Action Items	`ACTION: <name> to <what they are supposed to do>`	`ACTION: sandro to make a wiki page about scribe conventions`
Setting Topic	`Topic: <title of new topic>`	`Topic: How to Scribe Effectively`
Proposals	`PROPOSED: <proposal text>`	`PROPOSED: The first thing we do, let's kill all the lawyers.`
Resolutions (after voting)	`RESOLVED: <proposal text reiterated>`	`RESOLVED: The first thing we do, let's kill all the lawyers.`

More advanced commands (often used after the meeting, when editing the log). Don't worry about learning them before scribing.


Scribe Activity	IRC syntax	Example
Provide a summary of the current (sub)topic (often added after-the-fact)	`summary: <text of summary>`	`summary: Four proposals were considered, but none had consensus`
Setting Sub-topic	`Subtopic: <title of new sub-topic>`	`subtopic: Location of Dinner during F2F`
Setting Sub-Sub-Topic	`Subsubtopic: <title of new sub-sub-topic>`	`subsubtopic: Importance of good desert menu`
Recording Attendance	`Present: <list of people who are present>`	`present: sandro, ian, evan, bijan`
Recording Remote Attendance (for F2F meetings)	`Remote: <list of people attending remotely>`	`remote: dave, deborah`
Recording Regrets	`Regrets: <list of people unable to attend>`	`regrets: frank, jim`
Recording Chair	`Chair: <list of people chairing the meeting>`	`chair: Ian`
Making a note which does not appear in final record	`Omit: <text which does not appear>`	`omit: This line is sort of commented out; it's logged but not usually displayed`

See Common Scribe Manual for full details. Summary:

Copy the chat log to the wiki. The easiest way is to use the Common Scribe control panel. Just pick the group (and maybe subgroup) and "Copy".
Do some cleanup:
1. If someone writes a line of the form "word: text" that is not really a scribe-assist, then insert a space before the word.
2. Optionally add "Subtopic:" and even "Subsubtopic:" entries
3. Optionally add a "#" prefix to "comment out" lines which you don't want to delete (because you're not sure they should be gone).
4. Optionally add "summary:" lines (one per topic/subtopic) giving a summary of that section
5. Check the agenda for regrets, and add them to the minutes, by adding a line of the form:
```
<your_nick_here> REGRETS: ?names
```
6. Add the chair:
```
<your_nick_here> CHAIR: ?name
```
Look at your work by clicking on the "preview nicely formatted version" link.
- Correct any "scribe errors" shown there. Typically they involve name ambiguity and typos.
Fix the list of people present:
1. If there are guests present, add lines like
```
<your_nick_here> Guest: Firstname (nickname) Lastname, Affiliation
```
2. If the list of attendees automatically gathered isn't right, over-ride it with a line like PRESENT: Sandro_Hawke, John_Smith, Davey_Jones
  - The names in this list should be unambiguous with respect to official list of participants, (and their nicknames) as in tracker. In addition to showing who was at the meeting, this line tells CommonScribe which names to match against in disambiguating names.