Scribe Instructions

From W3C eGovernment Wiki
Jump to: navigation, search

Before scribing

  • Invite Zakim and RRSagent
/invite Zakim
/invite RRSagent
  • Set the topic of the meeting to the meeting agenda
/topic <URL of meeting agenda>
  • Set the meeting
Zakim, this will be egov
  • Set the scribe ("scribe" vs "scribenick" doesn't matter for our current tools)
Scribe: <scribe>
  • Make records public
RRSAgent, make records public

While scribing

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

After scribing

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.
  • Use the "Save" button on that page. Edit and repeat as necessary.
  • Send e-mail to the group when you're satisfied.