Sync eng/common directory with azure-sdk-tools repository for Tools P…

…R 930
Azure · Aug 31, 2020 · 0eebe3e · 0eebe3e
1 parent c77746b
commit 0eebe3e
Showing 1 changed file with 6 additions and 2 deletions.
diff --git a/eng/common/README.md b/eng/common/README.md
@@ -19,5 +19,9 @@ The 'Sync eng/common directory' PRs will be created in the language repositories
 2. `azure-sdk-tools - sync - eng-common` is run automatically. It creates **Sync PRs** in each of the connected language repositories using the format `Sync eng/common directory with azure-sdk-tools for PR {Tools PR Number}`. Each **Sync PR** will contain a link back to the **Tools PR** that triggered it.
 3. More changes pushed to the **Tools PR**, will automatically triggered new pipeline runs in the respective **Sync PRs**. The **Sync PRs** are used to make sure the changes would not break any of the connected pipelines.
 4. Once satisfied with the changes;
-    - First merge all the **Sync PRs**. The **Tools PR** contains links to all the **Sync PRs**
-    - Finally merge the **Tools PR**. Each **Sync PR** contains the link to the corresponding **Tools PR**. 
+    - First make sure all checks in the **Sync PRs** are green and approved. The **Tools PR** contains links to all the **Sync PRs**.
+    - Next merge all the **Sync PRs** by approving the Review gate on the `azure-sdk-tools - sync - eng-common` run for the **Tools PR**. You can get to this by clicking on `Details` -> `View more details on Azure Pipelines`. You need EngSys permissions to reach the `azure-sdk-tools - sync - eng-common` pipeline.
+    - In the `azure-sdk-tools - sync - eng-common` run for you **Tools PR** click on `Review` -> `Approve`. This will cause all the **Sync PRs** to be merged.
+    - Finally merge the **Tools PR**. Each **Sync PR** contains the link to the corresponding **Tools PR**. 
+
+See [detailed eng/common Workflow](https://dev.azure.com/azure-sdk/internal/_wiki/wikis/internal.wiki/281/Engineering-Systems-Tools?anchor=eng%2Fcommon-workflow)