From 7c42c60d587ad4544a5ee326adfa8b1d23f72204 Mon Sep 17 00:00:00 2001
From: Peter Collins <pecolli@microsoft.com>
Date: Mon, 13 Feb 2023 15:50:41 -0500
Subject: [PATCH] [ci] Report issues in the API docs build log (#7784)

Context: https://github.com/xamarin/java.interop/issues/1071

Adds a step to the API docs build that will fail the job if any
problematic JavadocInfo messages are found in the log.
---
 .../automation/azure-pipelines-apidocs.yaml   | 22 +++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/build-tools/automation/azure-pipelines-apidocs.yaml b/build-tools/automation/azure-pipelines-apidocs.yaml
index bc6eb50c329..72b1e9b3ab4 100644
--- a/build-tools/automation/azure-pipelines-apidocs.yaml
+++ b/build-tools/automation/azure-pipelines-apidocs.yaml
@@ -117,3 +117,25 @@ stages:
       inputs:
         artifactName: Api Docs Diff
         targetPath: $(Build.StagingDirectory)/api-doc-diff
+
+    - powershell: |
+        $docsUpdateBinlog = Get-ChildItem -Path "$(Build.SourcesDirectory)/bin/Build$(XA.Build.Configuration)" -Filter *UpdateApiDocs-*.binlog | Select-Object -First 1
+        $buildLog = "$(Build.SourcesDirectory)/bin/Build$(XA.Build.Configuration)/temp-build.log"
+        & "$(Build.SourcesDirectory)/bin/$(XA.Build.Configuration)/dotnet/dotnet" build $docsUpdateBinlog > $buildLog
+
+        $issueContent = & {
+            Get-Content -Path $buildLog | Select-String "## Exception translating remarks"
+            Get-Content -Path $buildLog | Select-String "## Unable to translate remarks"
+            Get-Content -Path $buildLog | Select-String "JavadocImport-"
+        }
+
+        if ($issueContent) {
+            Write-Host "The following issues were found, review the build log for more details:"
+            Write-Host ""
+            foreach ($line in $issueContent) {
+                Write-Host $line
+                Write-Host ""
+            }
+            exit 1
+        }
+      displayName: Report issues in docs generation