About Woof!

Woof! tracks and exposes mailing list interactions.

It is typically useful for software development mailing lists where users report bugs, submit patches, propose feature requests, share tips, etc.

Reports

Adding a report

Adding a report to Woof! is done by using subject prefixes.

For the three main types of reports:

• bug : [BUG] or [BUG x] where x is a version number
• patch : [PATCH] or [PATCH n/m] or an email with a diff or patch attachment
• request : [FR] or one of [FP, RFC, RFE, TASK, POLL]

For other announcements:

• announcement : [ANNOUNCEMENT] or [ANN]
• blog : [BLOG] or [TIP]
• change : [CHANGE x] where x is a future (not released) version number
• release : [RELEASE x] or [REL x] where x is a version number

Report states

All report types can be in a combination of these states: (un)acked, (un)owned and (un)closed.

• Acked means that someone took the next sensical action: e.g. for a bug, someone confirmed it; for a patch, someone reviewed it.
• Owned means someone claimed to handle this report. You can own a report that has not been acked.
• Closed means the report has been closed, either because it has been fixed (for a bug), canceled or done in any fashion.

Updating a report

Some words at the beginning of a line in the body of a reply to a report trigger an update of this report.

By default, Approved will always ack a bug/patch/request, Handled will always mark a bug/patch/request as owned, Canceled will always close a bug/patch/request.

Canceled is the only report trigger for an announcement, a blog, a change and a release.

Note: These words (Confirmed, Approved, etc.) are case-sensitive and a punctuation mark among ;:,. is mandatory after each of them.

Updating the priority

You cannot set the priority of a report directly: it is computed based on whether the report is important and urgent.

But you can update a report as (un)important and/or (not-)urgent.

• To set a report as important, use "Important" in a reply.
• To set a report as unimportant, use "Unimportant" in a reply.
• To set a report as urgent, use "Urgent" in a reply.
• To set a report as not urgent, use "Not Urgent" in a reply.

Color codes

Report status

• ⬜ Unacked, unowned
• 🟦 Owned
• 🟨 Acked
• 🟩 Acked, Owned
• 🟥 Closed

Report priority

• ⬜ Unimportant, not urgent
• 🟨 Important
• 🟧 Urgent
• 🟥 Important and urgent

Using multiple triggers

You can use multiple triggers in the same email. E.g. in a reply against a bug report:

Confirmed.
Urgent.
Important.

will mark the bug report as confirmed, and set it as important and urgent, giving it the highest priority.

Updating a report without replying to the mailing list

Sometimes it can be useful to create or update a report without notifying all the subscribers of the mailing list: maintainers can do this by writing directly to the Woof! inbox (i.e. :inbox-user in the config_example.edn file.)

Say for example that someone sends a feature request; after two years, you decide to cancel this feature request but don't want to notify the list. In this case, and provided you are a maintainer of this Woof! instance, you simply hit "reply" from your email client and add the Woof! monitored email in the To: field: the report will be unlisted from feature requests.

This also goes for updating reports: say someone forgot to add the "[BUG]" prefix for reporting a bug. As a maintainer, you can edit the subject of the email you received and resend it to the Woof! inbox, it will be store as a bug report.

Search

Woof! web interface allow users to search reports.

• agenda will find reports which subject matches agenda
• from:user@woof.io will list reports from user@woof.io
• acked:user@woof.io will list reports acked by user@woof.io
• owned:user@woof.io will list reports owned by user@woof.io
• closed:user@woof.io will list reports closed by user@woof.io

You can use abbreviations (f[rom], a[cked], o[wned], c[losed]) and combine search parameters:

• f:user1@woof.io a:user2@woof.io will list possible reports from user1@woof.io and acked by user2@woof.io.

Admins and maintainers

Each Woof! instance comes with a default admin.

Admins can update the main configuration:

• Global notifications: [true|false] : Enable/disable mail notifications globally
• Maintenance: [true|false] : Put the website in maintenance mode
• [Add|Remove] admin: woof@woof.io : Add or remove an admin
• [Add|Remove] maintainer: woof@woof.io : Add or remove a maintainer
• [Delete|Undelete]: woof@woof.io : Clean up past reports
• [Ignore|Unignore]: woof@woof.io : Ignore future reports

Add, Remove and (Un)Delete/(Un)Ignore commands can accept several arguments: you can use Ignore: user1@woof.io user2@woof.io to ignore future messages from these two users.

Maintainers can perform three actions:

• Add maintainer: woof@woof.io
• Delete: woof@woof.io
• Ignore: woof@woof.io

Note that maintainers cannot remove admins or other maintainers and they cannot undelete mails or unignore contributors.