User:Dogi/meeting

From OLPC
Jump to navigation Jump to search

Meeting (Bot)

What is it?

Meeting is a bot that has been designed to make the process of summarizing meetings easier. It is a modified [bot], running a custom script written in TCL.

Who Would Use It?

Meeting was designed for Chairperson of a meeting to use. A chairperson can flag parts of the meeting for specific topics, actions, and agreed resolutions, which will be outputted into a HTML, Plaintext, or Wiki Formatted document to enable easier browsing of the IRC chat logs.

How do I request the bot?

The bot will always be available in the #olpc-bot channel, If you are running a meeting in a different channel then contact someone in the #olpc-admin IRC channel on OFTC.

How do I use it?

The commands for the bot are shown below:

  • #startmeeting Tells the bot to start listening. Sets the meeting chair to whoever issues this command
  • #TOPIC Records a topic of discussion (Can only be issued by the meeting chair)
  • #IDEA Records an idea releated to the current topic of discussion (Can be used by everyone)
  • #ACTION Records an action that is decided on (Can only be issued by the meeting chair)
  • #AGREED Records and agreement on a idea (Can only be issued by the meeting chair)
  • #LINK Records a URL link of any format
  • #VOTE Starts a vote. (Can only be issued by the meeting chair)
  • +1 / -1 Records a vote for the current #VOTE. (Can be used by everyone)
  • #ENDVOTE Finishes the current #VOTE (Can only be issued by the meeting chair)
  • #endmeeting Ends the meeting (Can only be issued by the meeting chair)

Starting a Meeting

To begin the meeting, the chairperson issues the "#startmeeting" command. This tells the bot to start logging.

<dogi> #startmeeting
<meeting> Meeting started at 01:00

After issuing the #startmeeting command, the rest of the commands will be enabled.

Changing the Topic

As you progress through the meeting the current discussion point should be noted to enable easier reading of the IRC logs. You can change the current topic of discussion by issuing a [TOPIC] command:

<dogi> [TOPIC] Changing the Topic
<meeting> Current Topic: Changing the Topic

Ideas, Actions and Agreed Actions

The [IDEA] command are supplied so attendees can provide and log ideas regarding the current topic of discussion, this is useful in brainstorming sessions where all input should be registered for future examination.

{{{ <dogi> [IDEA] Provide full details of the commands on the Wiki <meeting> New Idea Received: Provide full details of the commands on the Wiki }}}

Similar to this is the [ACTION] and [AGREED] commands, but these can only be used by the Chairperson. This will add an entry into the log denoting a action to be taken, or a agreement on the current topic.

{{{ <dogi> [ACTION] Manual to be produced by dogi <meeting> New Action Received: Manual to be produced by dogi

<dogi> [AGREED] Work on documentation will commence as soon as possible <meeting> Agreed: Work on documentation will commence as soon as possible }}}

Voting

The bot offers a voting mechanism to enable the chairperson to hold a public vote regarding a particular topic. A vote is started via the [VOTE] command.

{{{ <dogi> [VOTE] Do we implement channel management? <meeting> New Vote: Do we implement channel management? }}}

Atendees can vote by using the +1/-1 commands:

{{{ <dogi> +1

<hhenry> -1 }}}

After a time the chairperson can close the vote (using the #endvote command) and receive the results:

{{{ <dogi> #endvote <meeting> Vote on "Do we implement channel management?", 1 For, 1 Against }}}

Ending the Meeting

After all topics are discussed, the chairperson can then call a close to the meeting using the #endmeeting command

{{{ <dogi> #endmeeting <meeting> Meeting Ended: 01:11 <meeting> Summary available at: http://meeting.laptop.org/test-20081104.html }}}


What output does the bot produce?

Some recent output can be found [[1]]

Can I see the bot in action?

You can try the bot out in the #meeting-test channel on Freenode and OFTC. If you have any further questions just ask someone in the #olpc-admin channel on OFTC. Please feel free to try out starting meetings and various other commands, but we ask if someone else is testing the bot that you wait until they've finished.

Do you have an example test script?

Yes, check the User:Dogi/Meeting/TestScript page for an example testscript that will use all of ``Meeting's features.