Typical reason is that the tspconfig.yaml in PR configures a new Java SDK. Hence we cannot compare it with existing SDK (neither apiview nor changelog).
We had to create the apiview revision that 1. before the migration; 2. after the migration, and compare them.
- create a folder in SDK repo, e.g. sdk/alertsmanagement/azure-resourcemanager-alertprocessingrules
- in this folder, run autorest, target azure-rest-api-specs main branch
autorest --use=@autorest/java@latest --java --java.output-folder=. --fluent=lite --java.fluent=lite --java.license-header=MICROSOFT_MIT_SMALL --modelerfour.lenient-model-deduplication --input-file=/c/github/azure-rest-api-specs/specification/alertsmanagement/resource-manager/Microsoft.AlertsManagement/AlertProcessingRules/stable/2021-08-08/AlertProcessingRules.json - run
mvn source:jar - commit the new code (commit is not important, but it gives you a chance to roll back, if there is something wrong in later steps)
- create a new apiview, upload the jar in
targetfolder - run autorest again (same command), target azure-rest-api-specs PR branch
- run
mvn source:jar - commit the code change
- in the apiview created in step 5, "add revision", upload the jar from same place (now updated), use any "label"

- in apiview, check the diff (compare the latest revision, with the previous revision in step 5)

- If nothing major, mark the migration as green
Example apiview https://spa.apiview.dev/review/7d97d70fc4fd49a081e0ebbd647fce1f?activeApiRevisionId=ba4dee3b635e4c6f9c4da65030ece82a&diffApiRevisionId=6ed94c83a4f340d3bad3fbb360663c46&diffStyle=trees
