Notes on scribing

From OWEA
Jump to: navigation, search

IRC Sessions to Real Readable Notes

Before the Meeting Commences:

Step 1: Invite trackbot, Zakim and RRSAgent

  • /invite trackbot #owea
  • trackbot, start telcon

Trackbot will invite the other bots, Zakim and RRSAgent, and initialize the telcon.

Step 2: Set Meeting Info

Important to do:

  • Zakim, this will be OWEA
  • ScribeNick: IRC_screen-name (example - scribenick: gsims)
  • meeting: OWEA XG Teleconference
  • chair: Real_Name (example - chair: Steph Troeth)

Optional

  • RRSAgent, set logs world-visible (for groups with open proceedings)
    • RRSAgent, set logs member-visible (for member-confidential minutes)
  • scribe: IRC-nick
  • agenda: URI
  • Previous: URI (provides pointer to last minutes)
  • present: <names separated by commas>
  • regrets: <names separated by commas>
  • RRSAgent, pointer? (gives location of IRC log)
  • zakim, save agenda (after agenda entered)
  • zakim, Wrong_Name is Correct_Name

During the Meeting:

  • Topic: blah blah blah (will create headers in minutes and TOC)
  • Indicate who said what by prefixing that line with their username (john: words of wisdom). You can just type "j" and tab, and IRC will fill in the rest.
  • trackbot, status? (shows the users trackbot knows about)
  • ACTION: TrackbotName ActionText - DueDate
  • RESOLVED: [info]
  • RESOLUTION: [info]
  • zakim, phone-number is IRC-nick
  • zakim, mute me
  • zakim, unmute me
  • correction syntax: s/teh/the
    • note: correction syntax for the IRC tracker is a sub-set of sed
  • q+ (puts you in the speaker queue)
  • q- (remove yourself from the speaker queue)
  • q+ to ask ...
  • q+ to say ...
  • present+ Real_Name (to add late arrivals)
  • present- PhoneCode (to remove coded IDs)
  • regrets+ Real_Name for last minute regrets
  • RRSAgent, pointer? (gives location of IRC log)
  • zakim, choose a victim (randomly assigns a task to a participant)
  • Switching Scribes:
    • ScribeNick: IRC_nick
    • after-the-fact: i/Text_Where_Scribe_Changed/ScribeNick: IRC_name
  • RRSAgent, drop action # (to drop a malformed action)
  • close ISSUE-# (how to close an issue from IRC)
  • close ACTION-# (how to close an action item from IRC)
  • trackbot, status? (shows the users trackbot knows about)

After the Meeting Adjourns:

The scribe can simply use trackbot to end the telcon, like this:

  • trackbot, end telcon

Seriously...just type trackbot, end telcon. No need to type the stuff below, it happens automatically.

Trackbot, in turn, will initiate the following commands:

  • Turn RRSAgent Logging Off
    • use the following command to turn RRSAgent's logging function off, so that any bot instructions or side chatter that follows the meeting's adjournment are not included in the meeting's log:
      • RRSAgent, stop
  • Creating Minutes:
    • RRSAgent, create minutes
    • note: the following 5 commands are synonyms:
      • RRSAgent, draft minutes
      • RRSAgent, format minutes
      • RRSAgent, generate minutes
      • RRSAgent, make minutes
      • RRSAgent, publish minutes

Dismissing Zakim and RRSAgent

1) zakim, please part (this will result in the output of attendees)

NOTE: non-staff members who are acting as scribe MUST effect any changes or corrections BEFORE dismissing RRSAgent; staff can edit slash manipulate minutes by appending a comma and the word tools to the URI for the minutes - for example:

http://www.w3.org/2008/09/25-owea-minutes.html,tools

NOTE: the naming syntax for the automatically generated documents is:

http://www.w3.org/YYYY/MM/DD-[IRC_Channel]-minutes.html
http://www.w3.org/YYYY/MM/DD-[IRC_Channel]-irc

2) after dismissing zakim, issue an "RRSAgent, draft minutes" command to ensure that the attendees list is correctly populated -- use the plus (+) and minus (-) syntax to add or delete attendees, regrets, etc. -- remember that you MUST issue an "RRSAgent, draft minutes" command in order for the bot to execute your instructions -- every time you do so, be sure to REFRESH the document in the browser instance in which you are reviewing the draft minutes

3) Very Last Step: RRSAgent, please part (logs actions and resolutions)

4) email HTML and IRC log pointers to public-xg-owea@w3.org (including a text dump of the minutes is optional, although appreciated by many)

5) Say good-bye to trackbot trackbot, leave