aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorVratko Polak <vrpolak@cisco.com>2020-04-16 16:23:58 +0200
committerVratko Polak <vrpolak@cisco.com>2020-04-20 09:20:25 +0000
commit03e25808b9ea34aaa9b6a59e43899d3ac262fdae (patch)
tree61eb24970cd5f1af587f2c1889ab456dc8527f05 /docs
parent7a9dfe35a2d80be24ba04ac6a4e5dd2983dd02d4 (diff)
Flag day: requirements for candidates
Change-Id: I0446263333812a57a8d0f7f288044482bee04a14 Signed-off-by: Vratko Polak <vrpolak@cisco.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/automating_vpp_api_flag_day.rst20
1 files changed, 17 insertions, 3 deletions
diff --git a/docs/automating_vpp_api_flag_day.rst b/docs/automating_vpp_api_flag_day.rst
index 00cb6000d6..2268cf496f 100644
--- a/docs/automating_vpp_api_flag_day.rst
+++ b/docs/automating_vpp_api_flag_day.rst
@@ -1,5 +1,5 @@
..
- Copyright (c) 2019 Cisco and/or its affiliates.
+ Copyright (c) 2020 Cisco and/or its affiliates.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at:
@@ -189,9 +189,21 @@ Changes
This process does not specify what to do with CSIT-blocked changes
that are not also API changes.
-+ The *active API change*: The API change currently being processed
++ A *candidate API change*: An API change that meets all requirements
+ to become active (see below). Currently, the requirements are:
+
+ + No -1 nor -2 from from any human reviewer.
+
+ + All verify jobs (except vpp-csit ones) pass.
+
+ + +1 from a VPP committer.
+
+ The reason is to avoid situations where an API change becomes active,
+ but the VPP committers are unwilling to merge it for some reason.
+
++ The *active API change*: The candidate API change currently being processed
by the API Flag Day Algorithm.
- While many API changes can be open (waiting/queued/scheduled),
+ While many API changes can be candidates at the same time,
only one is allowed be active at a time.
+ The *activating change*: The name for a Gerrit Change for CSIT repository
@@ -233,6 +245,8 @@ The following steps describe the application of the API "Flag Day" algorithm:
#. If the api-crc job fails, an email with the appropriate reason
is sent to the VPP patch submitter and vpp-api-dev@lists.fd.io
including the VPP patch information and .api files that are edited.
+#. The VPP patch developer works with a VPP committer
+ to ensure the patch meets requirements to become a candidate (see above).
#. The VPP patch developer and CSIT team create a CSIT JIRA ticket
to identify the work required to support the new VPP API version.
#. CSIT developer creates a patch of the deactivating change