General information

Meetingology is a bot running on the #ubuntu-meeting channel and some other channels on the Freenode network. Its purpose is to facilitate meetings and take the minutes. The general principles are as follows:

• The bot should be quiet unless it has something useful to say. The bot won't echo every command in the channel, but it might confirm in a private message to the user that it understood things (this principle is not yet fully implemented).
• Writing minutes is an activity unworthy of a human, the post meeting minutes process should be copy-paste-done.
• Command compatible with the old Mootbot: you can use [topic] instead of #topic.
• The meeting minutes consist of a summary of the important points, plus a full log of the meeting.

Using the bot

Managing the meeting

• #startmeeting <meetingtopic>
  Starts the meeting and sets the meeting topic to <meetingtopic>.

  #meetingtopic <topic>
  Sets the meeting topic to <topic>. Use this if you forgot to set the meeting topic when starting the meeting.

  #endmeeting
  Ends the meeting. Can be used by any chair or any op on the channel.

Chair(s) and attendants

• #chair <nick> <nick> ...
  Set any number of people to be chairs of the meeting.

  #unchair <nick>
  Removes any user from the set of chairs of the meeting.

  #nick <nick>
  Adds a nick that has not spoken to the attendants. You can also use this to create a person/respondant for any action item in the minutes.
  Example:
  

  • #nick CommunityCouncil
    #action CommunityCouncil will produce report on . . .
    

Topics

• #topic <topic>
  Sets the current meeting topic to <topic>, which is also saved in the meeting minutes. If the bot has rights, also changes the channel topic.

  #subtopic <topic>
  Sets the current meeting subtopic to <topic>, which is also saved in the meeting minutes.
  Alias: #progress

Meeting minutes

• #accepted <text>
  Adds an "accepted" item in the meeting minutes.
  Alias: #accept

  #action <text>
  Adds an "action" item in the meeting minutes. The <text> should have one or more nicks in it.

  #agreed <text>
  Adds an "agreed" item in the meeting minutes.
  Alias: #agree

  #help
  Adds a "help" item in the meeting minutes. This indicates that the meeting attendants/team need help from somebody.
  Alias: #halp

  #idea <text>
  Adds an "idea" item in the meeting minutes.

  #info <text>
  Adds an "info" item in the meeting minutes.

  #rejected <text>
  Adds a "rejected" item in the meeting minutes. Opposite to #agreed.

Voting

• #vote <subject>
  Starts a vote on <subject>. Votes are given by saying +1, 0 or -1 on the channel. Votes are counted once, but you can change your mind as many times as you want before the voting ends.

  #votesrequired <count>
  Specifies the number of votes needed until the vote will pass. Example: #votesrequired 2 means you either need an aggregate of +2 or -2 to pass. Example: if you don't want a 0 to be a deadlock (e.g. if everyone abstains then the vote should fail) then set #votesrequired 1.

  #voters <nick> <nick> ...
  Set the qualified voters. Use '#voters all' to reset.

  #endvote
  Ends the vote and announces the results as well as adds them to the meeting minutes.

Other bot commands

• #commands
  Lists the commands the bot understands. This is called by #startmeeting so you shouldn't need it.

  #link
  Pasting a link to the channel already adds a link in the meeting minutes.

  #lurk and #unlurk
  Don't use this. Makes the bot quiet/not so quiet. For debugging only.

  #meetingname
  Sets the meeting name. Use #meetingtopic instead.

  #replay
  Don't use this. WIP. The idea is to reprocess raw logs looking for meeting commands and output formatted meeting minutes.

  #restrictlogs
  Don't use this. Untested feature that chmods log files. Useless in publicly logged channels.

  #save
  Don't use this. Flushes meeting minutes to disk. This is called by #endmeeting.

  #undo
  Undoes the last command from the logs. Doesn't always work.