meetingology

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

Ubuntu

Commands marked with a Circle of Friends can be given by anyone, not only the chair or an op.

Managing the meeting

  • #startmeeting <meetingtopic> Ubuntu
    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> Ubuntu
    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> Ubuntu
    Adds an "idea" item in the meeting minutes.

    #info <text> Ubuntu
    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 Ubuntu
    Lists the commands the bot understands. This is called by #startmeeting so you shouldn't need it.

    #link Ubuntu
    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.

meetingology (last edited 2016-12-13 20:09:36 by eylul)