View source for Scribing Commands and Related Info

This document provides some basic scribing commands and related information.

== Scribe Commands and Tips for During the Meeting==

* <tt>Scribe: Name</tt> (assigns the scribe)
* <tt>SpeakersInitials/IRC nickname: (capture the gist of what the person says)</tt>
* <tt>... (continue capturing what is being said without retyping the same speaker's initials or name again.)</tt>
** If you don't know who is speaking, ask the speaker to identify themself.
** Ask the speaker to repeat what he or she said, if it is important and you missed it.
* <tt>Zakim, next item</tt> (brings up the next agenda item) or you can use <tt>TOPIC:</tt> at the start of each agenda topic.
** If Zakim says the agenda was just opened, say <tt>Zakim, close this item</tt> then re-issue the next item command.
* <tt>RESOLUTION: (resolution text)</tt><br />i.e., <tt>RESOLUTION: Updated CFC proposal accepted.</tt>
* <tt>s/misspelling/correct spelling/</tt> (Syntax to correct spelling errors and mistakes) i.e.,<br /> <tt>s/staus/status/</tt><br />Note this must be written '''absolutely perfectly''' (any difference of case, punctuation, spacing, etc will cause it to fail), and it chokes if you have a slash in what you are trying to change.
** <tt>@@</tt> can be used as a marker while scribing for information missed that you want to fill in later. Then before sending the minutes search for "@@" and use the s/X/Y/ syntax to fill in any missing details. It may help to add a number, such as @@1, @@2, as the replacement command will only replace the most recent instance of the search string.

==Scribe Post-Meeting Commands and Tasks==

* <tt>rrsagent, make minutes</tt>
** Wait a couple minutes, then check if the minutes load at the URI rrsagent gives.
** If the URI shows 403 after a few minutes, try <tt>rrsagent, make log world</tt> to make sure the minutes are publicly visible.
** If the minutes don't show up after a few minutes still, re-issue the make minutes command. Sometimes it takes a couple tries.
* <tt>zakim, end meeting</tt>
** will generate the minutes one more time and dismiss the bots.  If needed, <tt>zakim, bye</tt> and <tt>rrsagent, bye</tt> will dismiss them individually.
* Draft an email that contains a link to minutes.
** It is appreciated to have any Resolutions near top of email.
** Very short (perhaps bulleted) summary is much appreciated.  The agenda can very help with this.
* Send the email to the group.

==Related Commands==

===During the Meeting Commands for Participants===
*  If something is scribed wrong or not well enough don't be afraid to improve it with the s/X/Y/ syntax as described above. 
* <tt>present+ Your Name</tt> (Each person present should add themself to the list of people present)
* <tt>q+</tt> (adds you to the speaker queue. Try to use the queue rather than jumping in on a conversation.)
* <tt>q-</tt> (removes you from the speaker queue)
* <tt>q+ to say [topic]</tt> (adds you to the speaker queue with an indication of what you want to say, which helps the chair prioritise.)
* <tt>/me non-minuted comment</tt> (to make a comment that you don't want recorded in the minutes) i.e., <br /><tt>/me feels like a beer</tt> (will not get recorded) but <br /><tt>I feel like a beer</tt> (will be recorded for posterity. And also make the minutes more painful to read.)
* <tt>/msg rrsagent help</tt> (get rrsagent help in a private channel rather than cluttering up the entire thing)
* <tt>/msg zakim help</tt> (get zakim help in a private channel rather than cluttering up the entire thing)

===Pre-Meeting Setup Commands for those Running the Meeting===
* <tt>agenda: url</tt>
* <tt>rrsagent, set logs world-visible</tt>
* <tt>regrets+ person's_name, person's_name, person's_name, person's_name</tt>
* <tt>Zakim, agenda?</tt>
* <tt>Chair: Chair's Name</tt> (assigns the chair for the meeting)

==Further Information==
* [https://lists.w3.org/Archives/Public/w3c-wai-ua/2008AprJun/0114.html GJR's Scribe's Cheat Sheet (2008-05-19 version)] by Gregory J. Rosmaita
* [http://www.w3.org/2001/12/zakim-irc-bot Zakim]
* [http://www.w3.org/2002/03/RRSAgent RRSAgent]
* [http://dev.w3.org/2002/scribe/scribedoc Scribe]
* [http://www.w3.org/2005/06/tracker/irc Tracker]
* [https://www.w3.org/2006/tools/wiki/WebExBestPractices WebEx Best Practices]