Using the IRC channel to document teleconferences
http://www.w3.org/2006/07/SWD/Scribing.html
Tom Baker
----------------------------------------------------------------------
About these guidelines
In W3C teleconferences, the IRC channel is used not only
to record communication among the attendees, but also to
control two robots (see Further Reading below):
-- <RRSAgent>, a helpful bot for recording an IRC session;
-- <Zakim>, an IRC bot that interacts with W3C's Zakim audio
teleconference bridge.
----------------------------------------------------------------------
1. Before the teleconference, the W3C Team Contact prepares Zakim and RRSAgent
1.1. RalphS invokes Zakim and RRSAgent
<RalphS> /invite Zakim #swd
<RalphS> /invite rrsagent #swd
<RalphS> rrsagent, bookmark
<RRSAgent> logging to http://www.w3.org/2006/10/24-swd-irc
<Ralph> zakim, this will be swd
<Zakim> ok, Ralph; I see SW_SWD()11:00AM scheduled to start in 5 minutes
1.2. RalphS provides basic information for the record
<RalphS> Meeting: SWD WG
Chair: Tom
Agenda: http://lists.w3.org/Archives/Public/public-swd-wg/2006Oct/0047.html
Previous: 2006-10-17 http://www.w3.org/2006/10/17-swd-minutes.html
Regrets: Diego, Fabien
Regrets+ Alistair, Guus
rrsagent, please make record public
----------------------------------------------------------------------
2. Everyone else joins
2.1. Attendees join an IRC channel in one of the following ways:
-- irc://irc.w3.org:6665/swd - by clicking on this in their browser
-- irc:irc.w3.org (port 6665), #swd - by using an IRC client
-- http://www.w3.org/2001/01/cgi-irc - by using W3C's Web-based IRC (member-only)
2.2. Everyone dials in to the Zakim Teleconference Bridge
-- +1-617-761-6200
-- conference code 79394# ('SWDWG')
2.3. Caller IDs are associated with IRC nicks
<Zakim> +??P39
<RalphS> zakim, ??p39 is Antoine
<Zakim> +Antoine; got it
<Zakim> + +1.650.450.aabb
<RalphS> zakim, aabb is Daniel
<Zakim> +Daniel; got it
<RalphS> zakim, nick TomB is Tom
<Zakim> ok, RalphS, I now associate TomB with Tom
<benadida> zakim, I am Ben_Adida
<RalphS> zakim, Ben_Adida is with RalphS
<Zakim> +Ben_Adida; got it
2.4. Zakim reports who is on the call
<TomB> zakim, who is here?
<Zakim> sees on the phone: TomB, Antoine, SeanB, +44.120.682.aaaa, Elisa_Kendall
sees on irc: benadida, Elisa, SeanB, Antoine, RRSAgent, TomB, Zakim, RalphS
----------------------------------------------------------------------
3. The meeting starts
3.1. Scribe is designated
<RalphS> Scribe: Daniel
Scribenick: Dlrubin
3.2. First agenda topic is started
<RalphS> Topic: Admin
3.3. Scribe records a presentation, indicating continuation with "..."
<Dlrubin> Elisa: see XMDR www.xmdr.org and look at latest UML and OWL versions
<Dlrubin> ... though a bit out of sync with the document text
<Dlrubin> ... they've recently sent me XMI stuff
3.4. Attendees chime in with links ("->")
<TomB> -> http://hpcrd.lbl.gov/SDM/XMDR/overview.html
<RalphS> -> http://www.xmdr.org/ eXtended MetaData Registry Project
3.5. Someone raises hand, is called on, speaks, and is scribed
<SeanB> q+ to ask about migration from "scruffy" to "neat"
<Zakim> sees SeanB on the speaker queue
<TomB> ack SeanB
<Zakim> SeanB, you wanted to ask about migration from "scruffy" to "neat"
<Dlrubin> SeanB: Is there a gray area between scruffy and neat?
3.6. Whenever the scribe presents, someone else steps in to scribe
<RalphS> Scribenick: Antoine
<Antoine> Daniel: As we already have SKOS documents...
3.7. Next agenda topic is started
<RalphS> Topic: RDF in XHTML
----------------------------------------------------------------------
4. Actions and decisions are recorded
4.1. Scribe records an action ("ACTION:")
<Dlrubin> ACTION: Elisa to post announcement to SWD list
<RRSAgent> records action 2
4.2. Scribe (or RalphS) pastes an action from the agenda into IRC
(and thus into the minutes), indicating its status on next line
<RalphS> ACTION: Alistair give pointers to deployed SKOS systems.
[recorded in http://www.w3.org/2006/10/17-swd-minutes.html#action06]
* RRSAgent records action 4
<RalphS> --continues
or
<RalphS> --dropped
or
<RalphS> --done
4.3. Scribe records a decision ("RESOLVED:")
<RalphS> RESOLVED: Next telecon will be 14 November, 1600 UTC
----------------------------------------------------------------------
5. Issues arising
5.1. Someone speaks off-the-record, using "/me" to hide from minutes
<TomB> /me dialing in...
5.2. Someone mutes their phone
<TomB> /me zakim, please mute me
<Zakim> Tom_Baker should now be muted
5.3. Scribe makes a mistake or omission - others correct
<Antoine> ???: charter for HTML WG has gone for review
<RalphS> s/???/Ralph/
<RalphS> s/has gone/has not yet gone/
----------------------------------------------------------------------
6. Meeting is closed
6.1. Meeting is adjourned and people hang up phones
<RalphS> [adjourned]
<Zakim> -Antoine
<Zakim> -Elisa
6.2. Scribe (or RalphS) requests a list of attendees "for the record"
<RalphS> zakim, list attendees
<Zakim> As of this point the attendees have been TomB, Antoine,
SeanB, Elisa_Kendall, Ralph, Ben_Adida, Bernard, Daniel
6.3. RRSAgent is asked to draft the minutes
<Dlrubin> rrsagent, please draft minutes
<RRSAgent> I have made the request to generate http://www.w3.org/2006/10/31-swd-minutes.html Dlrubin
6.4. RalphS closes Zakim and RRSAgent
<RalphS> zakim, bye
<--| Zakim has left #swd
<RalphS> rrsagent, bye
----------------------------------------------------------------------
7. Scribe edits and posts minutes
7.1. Scribe downloads and edits the HTML file
-- Saves http://www.w3.org/2006/10/31-swd-minutes.html locally.
-- Edits HTML to clarify who is talking when.
-- Deletes irrelevant IRC commands or chatter.
7.2. Scribe sends edited minutes to Ralph Swick <swick@w3.org>
for posting because WG participants do not normally have access
to the http://www.w3.org/2006/ tree.
7.3. Scribe downloads a plain-text copy of the finished minutes
"http://www.w3.org/2006/10/10-swd-minutes.html,text".
7.4. Scribe posts edited minutes to public-swd-wg@w3.org
A good example,
http://lists.w3.org/Archives/Public/public-swd-wg/2006Oct/0051.html
| Subject: "Meeting record: 2006-10-24 SWD telecon"
|
| The [1]record of yestersday's SemWeb Deployment WG
| telecon is ready for review. A text copy follows below.
|
1 | [1] http://www.w3.org/2006/10/24-swd-minutes.html
|
2 | Topics
| 1. [5]Admin
| 2. [6]SKOS Requirements
| 3. [7]RDF in XHTML
| 4. [8]Recipes for Publishing RDF Vocabularies
|
3 | Summary of Resolutions
|
| RESOLVED Next telecon will be 14 November, 1600 UTC
|
4 | Summary of Action Items
| [NEW] ACTION: Daniel to link his use case to SKOS draft [recorded in
| [19]http://www.w3.org/2006/10/24-swd-minutes.html#action01]
| [PENDING] ACTION: Alistair give pointers to deployed SKOS systems.
| [recorded in
| [20]http://www.w3.org/2006/10/17-swd-minutes.html#action06]
|
| The full text of the minutes follows.
|
| -----------------------------------------------------------------------
5 | [full text of minutes]
Notes:
1. Link to full meeting record.
2. Topics - pasted from draft minutes generated by RRSAgent.
3. Summary of Resolutions - plucked by hand from draft minutes ("nice to have")
4. Summary of Action Items - pasted from end of draft minutes generated by RRSAgent.
5. Full text of the revised minutes as per
http://www.w3.org/2006/10/10-swd-minutes.html,text
----------------------------------------------------------------------
Further reading
-- http://www.w3.org/1998/12/bridge/Zakim.html (one page)
Who is using Zakim now; a link to the Zakim calendar.
-- http://www.w3.org/2002/01/UsingZakim (one page)
How to join a conference, mute your audio, raise your hand, etc.
-- http://www.w3.org/2005/rules/wg/wiki/UsingZakim (one page)
How to log into IRC before calling, hide Zakim commands from
the agenda, manage the speaker queue.
-- http://www.w3.org/2005/rules/wg/wiki/TeleconEtiquette (one page)
When to mute your phone, when to use IRC instead of talking.
-- http://www.w3.org/2001/12/zakim-irc-bot.html (twenty pages)
Full documentation for Zakim.
-- http://www.w3.org/2002/03/RRSAgent (six pages)
Full documentation for RRSAgent.
-- http://dev.w3.org/cvsweb/~checkout~/2002/scribe/scribedoc.htm
How to generate meeting minutes from an IRC Log.
Change log:
$Log: Scribing.html,v $ Revision 1.8 2007/09/07 10:18:05 swick Add wrapper to make this a valid XHTML document.