ASFBot: IRC services and archives

ASFBot offers many services for Apache projects on Internet Relay Chat (IRC). IRC is an application layer protocol that facilitates text communication. The chat process works on a client/server networking model. To enable these services, contact Infra, either with a Jira ticket or through #asfinfra on the official Apache Slack instance.

Note: Infra supports ASFBot primarily for use during ASF members' meetings. If projects want to add extensions so that ASFBot can do other things, they need to support those extensions rather than relying on Infra to do so.

Contents

• Reporting on repository commits and new Jira tickets
• Reporting on changes to Jira tickets
• Fetching issue information
• Secretary feature
• Record-keeping for meetings
• Technical information

Reporting on repository commits and new Jira tickets¶

ASFBot can report on new commits to your Subversion or Git repository and or report when someone creates, updates, or closes a Jira ticket. You can tailor the ASFBot reports to your individual needs, with multiline logs, compacted paragraphs, coloring, different report styles, etc.

You can subscribe to any repository you like, and get reports on any specific changes you prefer, as long as these changes are publicly available. Subscriptions are tag-based, meaning that any one tag will apply to both Subversion and git commits.

Reporting on changes to Jira tickets¶

If your channel is set up for Jira reporting, ASFBot keeps track of the latest changes to a Jira ticket. To view, for instance, the most recent comment pertaining to INFRA-1234, type:

ASFBot: comment INFRA-1234

Fetching issue information¶

ASFBot can help you find the correct information or link related to specific Jira or Bugzilla issues. To use this feature for issue #52230, type:

COUCHDB-1234

ASFBot returns a link to that Jira ticket or Bugzilla issue and, if available, a short issue summary.

Secretary feature¶

ASFBot provides a simple secretary feature. To leave a message for an absent person, write:

ASFBot: tell [recipient] [message]

ASFBot passes that message to the intended recipient the next time that person logs onto the channel.

Record-keeping for meetings¶

ASFBot can keep a record of meetings you hold on IRC and publish these in HTML format with an agenda, actions to be taken and a list of participants. Record keeping is available in channels where logging is enabled. To enable logging, contact Infra.

Record keeping works as follows:

• To initiate a meeting, type ASFBot: meeting start.
• To set an agenda,type #topic [agenda goes here] or use the /topic<!-- command to change the channel's topic. ASFBot will keep the original topic of the channel in memory, and change it back once the meeting is over.
• To add information to the meeting summary, type #info [something here].
• Anything contributed with [off] at the beginning will be considered off-the-record and will not become part of the meeting log.
• To add an action to be taken before the next meeting, type #action [action].
• To end a meeting and save a summary of it, type ASFBot: meeting end. This will end the record keeping and produce an HTML document containing the summary of the meeting and a log of everything participants wrote.
• To send an IRC meeting summary as an email to a recipient, type ASFBot: meeting send your@domain.tld. You will need to have been granted karma by Infra to perform this task.

ASFBot understands most meetbot commands, so #meetingstart and #meetingend will also start and end a recording of a meeting.

For an example of what a meeting summary may look like, check out this record of a CouchDB meeting.

Technical Information About ASFBot¶

The ASFBot source code