Swarm 2016.3 Guide (December 2016)

When reviews have so many versions that the spacing between version dots on the timeline would be less than 30 pixels, a horizontal scroll bar appears plus scroll left/right buttons.

Additionally, the timeline includes a button to limit comments to the current review version(s).

See Review timeline for details.

Users can disable review notifications from specific reviews without leaving the review itself. The user still receives notifications for comments in which they have been @mentioned, otherwise all notifications are review activity are disabled.

See Disable notifications for details.

Users can now see all of the comments flagged as tasks in a review, and can filter the task list to show only open, addressed, or verified tasks.

See Tasks for details.

The Swarm API has been enhanced for comments, to provide the filtering options: ignoreArchived, tasksOnly, and for specified taskStates. Also, results can be limited to specific review versions by using the new context[version] filter.

These changes bump the API version to v5.

See Comments : Swarm Comments for details.

The Download .zip button has been added to reviews and changelists. Click the button to download a ZIP archive of the review's or changelist's files.

See Changelists for details.

The review queue can now filter reviews to those authored by a specific user.

See Filtering open reviews for details.

When a project is converted from public to private, any associated followers are removed to prevent them from accessing the project and receiving project notifications. A warning to this effect is displayed when a project has existing followers and the Private checkbox is checked.

In Swarm's diff display, the Show whitespace now provides visual indicators for line ending characters.

Also, it is now possible to make ignoring whitespace the default (via the config setting ignore_whitespace_default).

See Diff configuration for details.

When a committed changelist was involved in a review, a new link to the review identifying the review's changelist is included in the review header, in addition to the View Review button.

Typically, Swarm does not send notifications to comment authors. Admins can use the new notify_self configuration item to send comment notifications to comment authors.

See notify_self for details.

Swarm does a better job of cleaning up the workspaces it manages, which should prevent situations where Swarm appeared to be broken.

The user profile page displays more information about project membership.

See Users for details.

In the global Review queue, you can use the new My Projects option to filter the list of reviews to those that belong to projects in which you are a member

See Filtering open reviews for details.

Swarm maintains a variety of information in the Helix Versioning Engine's keys facility. By default, users with list-level privileges can read these keys, which can include comments that contain excerpts of code they may not normally have access to.

The Helix Versioning Engine, version 2013.1/659207 or higher, has a configuration setting to require admin-level privileges for access to read and write keys. See Hiding Swarm storage from regular users.

Pre-commit reviews in a task stream are not yet supported.