diff --git a/eng/common/README.md b/eng/common/README.md index 227a572db2d8c..d619fa15a554f 100644 --- 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**. \ No newline at end of file + - 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) \ No newline at end of file