Using the IRC channel to document teleconferences

Adapted from http://www.w3.org/2006/07/SWD/Scribing.html (Tom Baker) by Antoine Isaac.

----------------------------------------------------------------------
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 Chair prepares Zakim and RRSAgent

1.1. Chair invokes Zakim and RRSAgent
     <antoine>   /invite Zakim #lld
     <antoine>   /invite rrsagent #lld
     <antoine>   rrsagent, bookmark
     <RRSAgent> logging to http://www.w3.org/2010/06/24-lld-irc
     <antoine>    zakim, this will be lld
     <Zakim>    ok, antoine; I see INC_LLDXG()10:00AM scheduled to start in 5 minutes

1.2. Chair provides basic information for the record
     <antoine>   Meeting:   LLD XG
                Chair:     Antoine
                Agenda:    http://lists.w3.org/Archives/Public/public-xg-lld/2010Jun/0108.html
                Previous:  2010-06-17 http://www.w3.org/2005/Incubator/lld/minutes/2010/06/17-lld-minutes.html
                Regrets:   Ray, Tom, Andras, Ed, Karen, Ross, Herbert, Nicolas
                Regrets+   [add here last moment regrets]
                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/lld - by clicking on this in their browser
     -- irc:irc.w3.org (port 6665), #lld  - by using an IRC client
     -- http://irc.w3.org/ - by using
W3C's Web-based IRC

2.2. Everyone dials in to the Zakim Teleconference Bridge
     -- +1-617-761-6200 
     -- conference code 55394# ("LLDXG")

2.3. Caller IDs are associated with IRC nicks
     <Zakim>    +??P39
     <TomB>   zakim, ??p39 is Antoine
     <Zakim>    +Antoine; got it

     <Zakim>    + +33.1.53.79.aaaa
     <emma>   zakim, aaaa is me
     <Zakim>    +emma; got it

     <antoine>   zakim, nick TomB is Tom
     <Zakim>    ok, antoine, I now associate TomB with Tom

     <jeff_> zakim, I am Jeff_Young

     <stu>   zakim, Jeff_Young is with stu
     <Zakim>    +Jeff_Young; got it

2.4. Zakim reports who is on the call
     <TomB>     zakim, who is here?
     <Zakim>    sees on the phone: TomB, Antoine, michaelp, +44.120.682.aaaa, emma
                sees on irc: benadida, emma, michaelp, Antoine, RRSAgent, TomB, Zakim, RalphS

----------------------------------------------------------------------
3. The meeting starts

3.1. Scribe is designated
     <antoine>   Scribe:     Michael
                Scribenick: michaelp

3.2. First agenda topic is started
     <michaelp>   Topic:      Administrative

3.3. Scribe records a presentation, indicating continuation with "..."
     <michaelp>  Elisa: see XMDR www.xmdr.org and look at latest UML and OWL versions
     <michaelp>  ... though a bit out of sync with the document text
     <michaelp>  ... they've recently sent me XMI stuff

3.4. Attendees chime in with links ("->")
     <TomB>     -> http://hpcrd.lbl.gov/SDM/XMDR/overview.html
     <michaelp>   -> http://www.xmdr.org/ eXtended MetaData Registry Project

3.5. Someone raises hand, is called on, speaks, and is scribed
     <bernard>    q+ to ask about equivalence between #lldxg and #lldata
     <Zakim>    sees bernard on the speaker queue
     <antoine>     ack bernard
     <Zakim>    bernard, you wanted to ask equivalence between #lldxg and #lldata
     <michaelp>  bernard: Is there a gray area between scruffy and neat?

3.6. Whenever the scribe presents, someone else steps in to scribe
     <michaelp>   Scribenick: antoine
     <antoine>  Michael: I think I prefer #lldata because...

3.7. Next agenda topic is started
     <michaelp>   Topic: Use cases and case studies

----------------------------------------------------------------------
4. Actions and decisions are recorded

4.1. Scribe records an action ("ACTION:")
     <michaelp> ACTION: All to comment on the template  http://www.w3.org/2005/Incubator/lld/wiki/UseCases#Use_Case_template
     <RRSAgent> records action 2

4.2. Scribe (or Chair) pastes an action from the agenda into IRC 
     (and thus into the minutes), indicating its status on next line

     <michaelp>  ACTION: All group members should please post an introduction to http://lists.w3.org/Archives/Public/public-xg-lld [recorded in http://www.w3.org/2005/Incubator/lld/minutes/2010/06/10-lld-minutes.html#action01]

     * RRSAgent records action 4
     <michaelp>   --continues
     or 
     <michaelp>   --dropped
     or 
     <michaelp>   --done

4.3. Scribe records a decision ("RESOLVED:")
     <michaelp> 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
     <michaelp>  ???: 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
     <michaelp>   [adjourned]
     <Zakim>    -Antoine
     <Zakim>    -Elisa

6.2. Scribe (or Chair) requests a list of attendees "for the record"
     <michaelp>   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
     <michaelp>  rrsagent, please draft minutes
     <RRSAgent> I have made the request to generate http://www.w3.org/2010/06/24-lld-minutes.html michaelp

6.4. Chair closes Zakim and RRSAgent
     <antoine>   zakim, bye
     <--| Zakim has left #lld
     <antoine>   rrsagent, bye

----------------------------------------------------------------------
7. Scribe edits and posts minutes

7.1. Scribe downloads and edits the HTML file
     -- Saves http://www.w3.org/2010/06/24-lld-minutes.html locally.
     -- Edits HTML to clarify who is talking when.
     -- Deletes irrelevant IRC commands or chatter.  

7.2. Scribe sends edited minutes to Antoine Isaac
     for posting because WG participants do not normally have access
     to the http://www.w3.org/2005/Incubator/lld tree.

7.3. Scribe posts link to edited minutes to public-xg-lld@w3.org


----------------------------------------------------------------------
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.