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.