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 that ASFBot is being phased out in 2021, to be replaced by a Slack-related service.
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.
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
ASFBot: comment INFRA-1234
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:
ASFBot returns a link to that Jira ticket or Bugzilla issue and, if available, a short issue summary.
ASFBot provides a simple secretary feature. To leave a message for an absent person, write:
ASFBot: tell [recipient] [message]
ASFBot passees that message to the intended recipient the next time that person logs onto the channel.
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:
ASFBot: meeting start.
#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.
#info [something here].
[off]at the beginning will be considered off-the-record and will not become part of the meeting log.
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.
ASFBot: meeting send firstname.lastname@example.org. You will need to have been granted karma by Infra to perform this task.
ASFBot understands most meetbot commands, so
#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.
The ASFBot source code