Swarm 2016.1 Guide (May 2016)

You can now view, list, search, add, edit and delete groups. Each group can have notifications enabled so that members of the group get emails anytime another member of the group creates a review or commits a change.

When viewing a group you may see activity performed by any member of the group and reviews created by any member of the group.

When listing groups, groups that you own or are a member of appear first, groups with notifications enabled appear second and lastly, groups are ordered by name.

See the Groups section and the “Groups” chapter for details.

Users can like comments. At the bottom of each comment Swarm now displays the number of likes and a heart icon. The icon can be clicked to 'like' the comment.

When a comment is liked, Swarm records the activity and sends an email notification to the author of the comment.

See Liking comments for details.

Version 2 adds the following functionality: list activity, list groups, fetch a group, create a group, update a group, delete a group, fetch a project, create a project, update a project, delete a project, transition a review and commit a review.

See Groups : Swarm Groups for details.

Swarm now requires users to be logged in by default. See Require login for details.

Improved performance for the Swarm blame button. Using a 20,000 line test file, this change reduces the rendering time from ~60s to ~2s in Firefox and Chrome. Internet Explorer 10 improves from ~730s to ~8s.

Added a My Reviews dropdown button to the Reviews page. This allows reviews to be filtered by those that you authored or those that you are participating in.

Added an option to disable Swarm's auto-registration of the P4.Swarm.URL property. See Client integration for details.

The X-Frame-Options header is now configurable. This header controls when Swarm can be embedded in frames. See X-Frame-Options header for details.

Testing with 10,000 users and a comment thread with 100 comments, page load times were reduced from 7s to 250ms.

Renamed config options for adding projects to be more consistent with other options. Existing settings are still honored. The 'security -> add_project_admin_only' option becomes 'projects -> add_admin_only'. The 'security -> add_project_groups' becomes 'projects -> add_groups_only'.

See Restricted Changes for details.

Updated the precompiled P4PHP binaries that come with Swarm to use P4API 2015.2/1340214.

To assist with troubleshooting email configuration problems Swarm now logs successful emails at the DEBUG (7) log level.

Updated the project toolbar to look more modern.

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.