presentations/gerrit-new-features-2.6/gerrit-new-features-2.6.txt - training/gerrit - Git at Google

 = What's new in Gerrit 2.6
 :backend: slidy
 :max-width: 70em
 :data-uri:

 [[title-page]]
 == What's new in Gerrit 2.6

 == What's new in Gerrit 2.6
 * link:http://gerrit-documentation.googlecode.com/svn/ReleaseNotes/ReleaseNotes-2.6.html[
 Release Notes]

 * Statistics
 +
 [width="50%",cols=">s,^m,^m,^m",options="header"]
 |==========================
 |                 |Gerrit 2.6 |Gerrit 2.5 |Gerrit 2.4
 |commits &#x278a; |1301       |508        |122
 |resolved issues
 |link:http://code.google.com/p/gerrit/issues/list?can=1&q=FixedIn=2.6[85]
 |link:http://code.google.com/p/gerrit/issues/list?can=1&q=FixedIn=2.5[51]
 |link:http://code.google.com/p/gerrit/issues/list?can=1&q=FixedIn=2.4[35]
 |contributors     |56         |34         |22
 |==========================
 +
 &#x278a; without merge commits

 == New Default Skin

 .Gerrit 2.6
 image:../../img/Gerrit-2.6-skin.png[Gerrit 2.6 Skin]

 .Gerrit 2.5
 image:../../img/Gerrit-2.5-skin.png[Gerrit 2.5 Skin]

 == Edit Commit Message from UI

 .Icon to edit Commit Message
 image:../../img/edit-commit-message-1.png[Edit Commit Message 1]

 .Dialog to edit Commit Message
 image:../../img/edit-commit-message-2.png[Edit Commit Message 2]

 == Edit Change Topic from UI

 .Icon to edit Change Topic
 image:../../img/edit-change-topic-1.png[Edit Change Topic 1]

 .Dialog to edit Change Topic
 image:../../img/edit-change-topic-2.png[Edit Change Topic 2]

 == `Add Comment` Button
 Below the summary comments there is now a button to add a comment.

 image:../../img/add-comment-button.png[Add Comment Button]

 == Support for Project Specific Labels
 Individual projects can add (or remove) score categories through
 link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.6/config-labels.html[
 labels] and link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.6/prolog-cookbook.html[
 Prolog rules]. +
 This makes the workflow completely customizable.

 image:../../img/custom-label.png[Custom Label]

 .project.config
 ----
 [label "IP"]
   function = MaxWithBlock
   value = -1 Bad
   value = 0 No score
   value = +1 Clean
 ----


 == File Level Comments
 It is now possible to comment on a whole file.

 .Icon to add a comment on a file
 image:../../img/file-comment-1.png[File Comment 1]

 .Editor for a comment on a file
 image:../../img/file-comment-2.png[File Comment 2]

 == Reviewed Panel at Bottom

 image:../../img/reviewed-panel-at-bottom.png[Reviewed Panel at Bottom]

 == New Submit Type `Rebase If Necessary`
 The 'Rebase If Necessary' submit type automatically rebases the
 changes on submit if needed. If a change gets rebased the rebased
 commit is added as a new patch set to the change.

 image:../../img/rebase-if-necessary.png[Rebase If Necessary]

 == Branch specific Submit Types
 The submit type for changes can now be controlled from Prolog. This
 enables branch specific submit types. E.g. for devlopment branches the
 submit type can be `Merge If Necessary` while for release branches it
 is `Fast Forward Only`.

 image:../../img/submit-type-on-change-screen.png[Submit Type]

 == Show in ApprovalTable if a Reviewer can't vote in a Category
 For a user that cannot vote in a category the cell in the category
 column of the ApprovalTable will be shown with a grey background.
 A tooltip explains that the user cannot vote in this category.

 image:../../img/reviewer-cannot-vote-in-category.png[Reviewer Cannot
 Vote In Category]

 == Voting on Draft Changes
 It is now possible to vote on draft changes.

 image:../../img/voting-2.png[Voting]

 == Filtering of Project List and Group List

 image:../../img/filter-projects.png[Filter Projects]

 == Query Icon for Projects
 The icon links to a default query or to the projects default
 dashboard.

 .In Project List
 image:../../img/query-icon-1.png[Query Icon in Project List]

 .On Change Screen
 image:../../img/query-icon-2.png[Query Icon on Change Screen]

 == Search Box

 === Suggestions
 The Search Box now provides suggestions for projects, groups and
 users.

 image:../../img/search-box-project-suggestion.png[Project Suggestion]

 === Animation
 When typing a query the search box is automatically expanded.

 .Collapsed
 image:../../img/search-box.png[Search Box]

 .Expanded
 image:../../img/search-box-expanded.png[Search Box Expanded]

 == Project Screens: Top Menus instead of Side Menus
 Also the last accessed project and the last accessed project screen
 are remembered.

 .Gerrit 2.6
 image:../../img/project-screen-top-menus.png[Project Screens Top Menus]

 .Gerrit 2.5
 image:../../img/project-screen-side-menus.png[Project Screens Side Menus]

 == Project Dashboards
 link:https://gerrit-review.googlesource.com/Documentation/user-dashboards.html#_project_dashboards[
 Project Dashboards] can be defined in `refs/meta/dashboards/*`.

 image:../../img/project-dashboards.png[Project Dashboards]

 == Custom Dashboard: Link Section Title to Query

 .Custom Dashboard
 image:../../img/to-query-1.png[Link Section Title to Query 1]

 .Query
 image:../../img/to-query-2.png[Link Section Title to Query 2]

 == Notifications

 * Project owners and site administrators can
   link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.6/user-notify.html[
   configure project level notifications]
 +
 ----
   [notify "team"]
     email = team-address@example.com
     email = paranoid-manager@example.com
 ----

 * watchers are notified if a draft change is published

 * support watching upload of new patch sets
 +
 image:../../img/email-notifications.png[Email notifications]

 * Automated system can control to whom notifications should be sent
   link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.6/rest-api-changes.html#set-review[
   when posting a review via the REST API]

 == Basic support for Avatars
 Plugins can provide avatar images for Gerrit users.

 .Avatar in Header
 image:../../img/avatar-1.png[Avatar 1]

 .Avatar in Settings Popup
 image:../../img/avatar-2.png[Avatar 2]

 == Login Screens
 The new form based HTML screens for login allow browsers to offer
 the choice to save the login data locally in the user's password store.

 image:../../img/login-screen.png[Login Screen]

 == Access Rights

 * ALLOW rule on the same project and ref overwrites BLOCK rule
 +
 By this an access right can be blocked for all users, while allowing
 it for a certain privileged group.
 +
 image:../../img/overwrite-block-rule.png[Overwrite BLOCK rule]

 * Global Capabilities are visible to all users who can see the
   `refs/meta/config` branch in `All-Projects`.
 +
 By this users can now propose changes to the global capabilities
 through code review.
 +
 image:../../img/global-capabilities.png[Global Capabilities]

 * New permissions for editing topics and viewing, deleting and
   publishing drafts
 +
 image:../../img/access-rights.png[Access Rights]

 == REST API

 * A big chunk of the Gerrit functionality is now available via the
   link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.6/rest-api.html[REST API].
 +
 The REST API is *NOT* complete yet and some functionality is still missing.
 +
 To find out which functionality is available, check the REST endpoint documentation for
 link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.6/rest-api-projects.html[projects],
 link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.6/rest-api-changes.html[changes],
 link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.6/rest-api-groups.html[groups] and
 link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.6/rest-api-accounts.html[accounts].
 +
 image:../../img/rest-endpoints.png[REST endpoints]

 * Support setting `HEAD` of a project
   link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.6/rest-api-projects.html#set-head[via REST].

 == GIT

 * *42x* improvement on `git clone` and `git fetch`
 +
 Running link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.6/cmd-gc.html[
 gerrit gc] allows JGit to optimize a repository to serve clone and fetch
 faster than C Git can, with massively lower server CPU required. Typically
 Gerrit 2.6 can completely transfer a project to a client faster than C Git
 can finish "Counting" the objects.

 * Support for options in ref spec
 +
 ----
   refs/for/master%r=alice,cc=bob,cc=charlie,topic=options
 ----

 * Support for link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.6/config-gerrit.html#core.useRecursiveMerge[
   recursive merge]
 +
 Still experimental, needs to be enabled by the administratior.


 == Plugins

 * support for JavaScript and GWT plugins
 * new extension point for commit validation
 * Plugins can contribute init steps
 * Plugins can contribute Prolog facts/predicates

 == Important fixes

 * Support for Internet Explorer 9 and 10

 * Fix auto closing of changes on direct push

 * Don't show error on ACL modifications
 ** if a section is added more than once or
 ** if empty permissions are added

 ++++
 <style type="text/css">
 #title-page {
   border-bottom: 0;
   text-align: center;
   position: relative;
   top: 30%;
   font-size: 60px;
 }
 </style>
 ++++
	= What's new in Gerrit 2.6
	:backend: slidy
	:max-width: 70em
	:data-uri:

	[[title-page]]
	== What's new in Gerrit 2.6

	== What's new in Gerrit 2.6
	* link:http://gerrit-documentation.googlecode.com/svn/ReleaseNotes/ReleaseNotes-2.6.html[
	Release Notes]

	* Statistics
	+
	[width="50%",cols=">s,^m,^m,^m",options="header"]
	\|==========================
	\| \|Gerrit 2.6 \|Gerrit 2.5 \|Gerrit 2.4
	\|commits ➊ \|1301 \|508 \|122
	\|resolved issues
	\|link:http://code.google.com/p/gerrit/issues/list?can=1&q=FixedIn=2.6[85]
	\|link:http://code.google.com/p/gerrit/issues/list?can=1&q=FixedIn=2.5[51]
	\|link:http://code.google.com/p/gerrit/issues/list?can=1&q=FixedIn=2.4[35]
	\|contributors \|56 \|34 \|22
	\|==========================
	+
	➊ without merge commits

	== New Default Skin

	.Gerrit 2.6
	image:../../img/Gerrit-2.6-skin.png[Gerrit 2.6 Skin]

	.Gerrit 2.5
	image:../../img/Gerrit-2.5-skin.png[Gerrit 2.5 Skin]

	== Edit Commit Message from UI

	.Icon to edit Commit Message
	image:../../img/edit-commit-message-1.png[Edit Commit Message 1]

	.Dialog to edit Commit Message
	image:../../img/edit-commit-message-2.png[Edit Commit Message 2]

	== Edit Change Topic from UI

	.Icon to edit Change Topic
	image:../../img/edit-change-topic-1.png[Edit Change Topic 1]

	.Dialog to edit Change Topic
	image:../../img/edit-change-topic-2.png[Edit Change Topic 2]

	== `Add Comment` Button
	Below the summary comments there is now a button to add a comment.

	image:../../img/add-comment-button.png[Add Comment Button]

	== Support for Project Specific Labels
	Individual projects can add (or remove) score categories through
	link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.6/config-labels.html[
	labels] and link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.6/prolog-cookbook.html[
	Prolog rules]. +
	This makes the workflow completely customizable.

	image:../../img/custom-label.png[Custom Label]

	.project.config
	----
	[label "IP"]
	function = MaxWithBlock
	value = -1 Bad
	value = 0 No score
	value = +1 Clean
	----


	== File Level Comments
	It is now possible to comment on a whole file.

	.Icon to add a comment on a file
	image:../../img/file-comment-1.png[File Comment 1]

	.Editor for a comment on a file
	image:../../img/file-comment-2.png[File Comment 2]

	== Reviewed Panel at Bottom

	image:../../img/reviewed-panel-at-bottom.png[Reviewed Panel at Bottom]

	== New Submit Type `Rebase If Necessary`
	The 'Rebase If Necessary' submit type automatically rebases the
	changes on submit if needed. If a change gets rebased the rebased
	commit is added as a new patch set to the change.

	image:../../img/rebase-if-necessary.png[Rebase If Necessary]

	== Branch specific Submit Types
	The submit type for changes can now be controlled from Prolog. This
	enables branch specific submit types. E.g. for devlopment branches the
	submit type can be `Merge If Necessary` while for release branches it
	is `Fast Forward Only`.

	image:../../img/submit-type-on-change-screen.png[Submit Type]

	== Show in ApprovalTable if a Reviewer can't vote in a Category
	For a user that cannot vote in a category the cell in the category
	column of the ApprovalTable will be shown with a grey background.
	A tooltip explains that the user cannot vote in this category.

	image:../../img/reviewer-cannot-vote-in-category.png[Reviewer Cannot
	Vote In Category]

	== Voting on Draft Changes
	It is now possible to vote on draft changes.

	image:../../img/voting-2.png[Voting]

	== Filtering of Project List and Group List

	image:../../img/filter-projects.png[Filter Projects]

	== Query Icon for Projects
	The icon links to a default query or to the projects default
	dashboard.

	.In Project List
	image:../../img/query-icon-1.png[Query Icon in Project List]

	.On Change Screen
	image:../../img/query-icon-2.png[Query Icon on Change Screen]

	== Search Box

	=== Suggestions
	The Search Box now provides suggestions for projects, groups and
	users.

	image:../../img/search-box-project-suggestion.png[Project Suggestion]

	=== Animation
	When typing a query the search box is automatically expanded.

	.Collapsed
	image:../../img/search-box.png[Search Box]

	.Expanded
	image:../../img/search-box-expanded.png[Search Box Expanded]

	== Project Screens: Top Menus instead of Side Menus
	Also the last accessed project and the last accessed project screen
	are remembered.

	.Gerrit 2.6
	image:../../img/project-screen-top-menus.png[Project Screens Top Menus]

	.Gerrit 2.5
	image:../../img/project-screen-side-menus.png[Project Screens Side Menus]

	== Project Dashboards
	link:https://gerrit-review.googlesource.com/Documentation/user-dashboards.html#_project_dashboards[
	Project Dashboards] can be defined in `refs/meta/dashboards/*`.

	image:../../img/project-dashboards.png[Project Dashboards]

	== Custom Dashboard: Link Section Title to Query

	.Custom Dashboard
	image:../../img/to-query-1.png[Link Section Title to Query 1]

	.Query
	image:../../img/to-query-2.png[Link Section Title to Query 2]

	== Notifications

	* Project owners and site administrators can
	link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.6/user-notify.html[
	configure project level notifications]
	+
	----
	[notify "team"]
	email = team-address@example.com
	email = paranoid-manager@example.com
	----

	* watchers are notified if a draft change is published

	* support watching upload of new patch sets
	+
	image:../../img/email-notifications.png[Email notifications]

	* Automated system can control to whom notifications should be sent
	link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.6/rest-api-changes.html#set-review[
	when posting a review via the REST API]

	== Basic support for Avatars
	Plugins can provide avatar images for Gerrit users.

	.Avatar in Header
	image:../../img/avatar-1.png[Avatar 1]

	.Avatar in Settings Popup
	image:../../img/avatar-2.png[Avatar 2]

	== Login Screens
	The new form based HTML screens for login allow browsers to offer
	the choice to save the login data locally in the user's password store.

	image:../../img/login-screen.png[Login Screen]

	== Access Rights

	* ALLOW rule on the same project and ref overwrites BLOCK rule
	+
	By this an access right can be blocked for all users, while allowing
	it for a certain privileged group.
	+
	image:../../img/overwrite-block-rule.png[Overwrite BLOCK rule]

	* Global Capabilities are visible to all users who can see the
	`refs/meta/config` branch in `All-Projects`.
	+
	By this users can now propose changes to the global capabilities
	through code review.
	+
	image:../../img/global-capabilities.png[Global Capabilities]

	* New permissions for editing topics and viewing, deleting and
	publishing drafts
	+
	image:../../img/access-rights.png[Access Rights]

	== REST API

	* A big chunk of the Gerrit functionality is now available via the
	link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.6/rest-api.html[REST API].
	+
	The REST API is NOT complete yet and some functionality is still missing.
	+
	To find out which functionality is available, check the REST endpoint documentation for
	link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.6/rest-api-projects.html[projects],
	link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.6/rest-api-changes.html[changes],
	link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.6/rest-api-groups.html[groups] and
	link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.6/rest-api-accounts.html[accounts].
	+
	image:../../img/rest-endpoints.png[REST endpoints]

	* Support setting `HEAD` of a project
	link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.6/rest-api-projects.html#set-head[via REST].

	== GIT

	* 42x improvement on `git clone` and `git fetch`
	+
	Running link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.6/cmd-gc.html[
	gerrit gc] allows JGit to optimize a repository to serve clone and fetch
	faster than C Git can, with massively lower server CPU required. Typically
	Gerrit 2.6 can completely transfer a project to a client faster than C Git
	can finish "Counting" the objects.

	* Support for options in ref spec
	+
	----
	refs/for/master%r=alice,cc=bob,cc=charlie,topic=options
	----

	* Support for link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.6/config-gerrit.html#core.useRecursiveMerge[
	recursive merge]
	+
	Still experimental, needs to be enabled by the administratior.


	== Plugins

	* support for JavaScript and GWT plugins
	* new extension point for commit validation
	* Plugins can contribute init steps
	* Plugins can contribute Prolog facts/predicates

	== Important fixes

	* Support for Internet Explorer 9 and 10

	* Fix auto closing of changes on direct push

	* Don't show error on ACL modifications
	** if a section is added more than once or
	** if empty permissions are added

	++++
	<style type="text/css">
	#title-page {
	border-bottom: 0;
	text-align: center;
	position: relative;
	top: 30%;
	font-size: 60px;
	}
	</style>
	++++