From 4c8d384c506f708f14b1f36eb0f38df79782ba07 Mon Sep 17 00:00:00 2001
From: Alice Li <alicejli@google.com>
Date: Tue, 25 Apr 2023 15:19:15 -0400
Subject: [PATCH] fix: update client header to use <h3> instead of <h2>

---
 .../src/main/java/com/microsoft/util/YamlUtil.java              | 2 +-
 .../src/test/java/com/microsoft/util/YamlUtilTest.java          | 2 +-
 .../expected-generated-files/com.microsoft.samples.yml          | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/third_party/docfx-doclet-143274/src/main/java/com/microsoft/util/YamlUtil.java b/third_party/docfx-doclet-143274/src/main/java/com/microsoft/util/YamlUtil.java
index 7f0a1f97..7fd6bbf6 100644
--- a/third_party/docfx-doclet-143274/src/main/java/com/microsoft/util/YamlUtil.java
+++ b/third_party/docfx-doclet-143274/src/main/java/com/microsoft/util/YamlUtil.java
@@ -35,6 +35,6 @@ public static String cleanupHtml(String text) {
                 .replaceAll("\\{@link *\"([^\\{]+)\" *\\}", "<a href=\"$1\">$1</a>")
                 .replaceAll("\\[([^]]+)]\\[([^]]+)\\]", "<xref uid=\"$2\" data-throw-if-not-resolved=\"false\">$1</xref>")
                 .replaceAll("\\{@link *([^\\{\"]+) *\\}", "<xref uid=\"$1\" data-throw-if-not-resolved=\"false\">$1</xref>")
-                .replaceAll("=======================([^=]+)=======================", "<h2>$1</h2>");
+                .replaceAll("=======================([^=]+)=======================", "<h3>$1</h3>");
     }
 }
diff --git a/third_party/docfx-doclet-143274/src/test/java/com/microsoft/util/YamlUtilTest.java b/third_party/docfx-doclet-143274/src/test/java/com/microsoft/util/YamlUtilTest.java
index 605a3b7c..b2856fda 100644
--- a/third_party/docfx-doclet-143274/src/test/java/com/microsoft/util/YamlUtilTest.java
+++ b/third_party/docfx-doclet-143274/src/test/java/com/microsoft/util/YamlUtilTest.java
@@ -121,7 +121,7 @@ public void cleanupHtmlAddHrefTagsTest() {
     @Test
     public void cleanupHtmlEqualTitlesTest() {
         String expectedActual = "======================= SpeechClient =======================";
-        String expectedResult = "<h2> SpeechClient </h2>";
+        String expectedResult = "<h3> SpeechClient </h3>";
         String random = UUID.randomUUID().toString();
 
         assertEquals(expectedResult, YamlUtil.cleanupHtml(expectedActual));
diff --git a/third_party/docfx-doclet-143274/src/test/resources/expected-generated-files/com.microsoft.samples.yml b/third_party/docfx-doclet-143274/src/test/resources/expected-generated-files/com.microsoft.samples.yml
index c1395567..5e519216 100644
--- a/third_party/docfx-doclet-143274/src/test/resources/expected-generated-files/com.microsoft.samples.yml
+++ b/third_party/docfx-doclet-143274/src/test/resources/expected-generated-files/com.microsoft.samples.yml
@@ -20,7 +20,7 @@ items:
   nameWithType: "com.microsoft.samples"
   fullName: "com.microsoft.samples"
   type: "Namespace"
-  summary: "The interfaces provided are listed below, along with usage samples.\n\n <p><h2> SpeechClient </h2>\n\n <p>Service Description: Service that implements Google Cloud Speech API.\n\n <p>Sample for SpeechClient:\n\n <pre class=\"prettyprint lang-java\"><code>\n try (SpeechClient speechClient = SpeechClient.create()) {\n   RecognitionConfig config = RecognitionConfig.newBuilder().build();\n   RecognitionAudio audio = RecognitionAudio.newBuilder().build();\n   RecognizeResponse response = speechClient.recognize(config, audio);\n }\n </code></pre>\n\n <p><h2> AdaptationClient </h2>\n\n <p>Service Description: Service that implements Google Cloud Speech Adaptation API.\n\n <p>Sample for AdaptationClient:\n\n <pre class=\"prettyprint lang-java\"><code>\n try (AdaptationClient adaptationClient = AdaptationClient.create()) {\n   LocationName parent = LocationName.of(\"[PROJECT]\", \"[LOCATION]\");\n   PhraseSet phraseSet = PhraseSet.newBuilder().build();\n   String phraseSetId = \"phraseSetId959902180\";\n   PhraseSet response = adaptationClient.createPhraseSet(parent, phraseSet, phraseSetId);\n }\n </code></pre>"
+  summary: "The interfaces provided are listed below, along with usage samples.\n\n <p><h3> SpeechClient </h3>\n\n <p>Service Description: Service that implements Google Cloud Speech API.\n\n <p>Sample for SpeechClient:\n\n <pre class=\"prettyprint lang-java\"><code>\n try (SpeechClient speechClient = SpeechClient.create()) {\n   RecognitionConfig config = RecognitionConfig.newBuilder().build();\n   RecognitionAudio audio = RecognitionAudio.newBuilder().build();\n   RecognizeResponse response = speechClient.recognize(config, audio);\n }\n </code></pre>\n\n <p><h3> AdaptationClient </h3>\n\n <p>Service Description: Service that implements Google Cloud Speech Adaptation API.\n\n <p>Sample for AdaptationClient:\n\n <pre class=\"prettyprint lang-java\"><code>\n try (AdaptationClient adaptationClient = AdaptationClient.create()) {\n   LocationName parent = LocationName.of(\"[PROJECT]\", \"[LOCATION]\");\n   PhraseSet phraseSet = PhraseSet.newBuilder().build();\n   String phraseSetId = \"phraseSetId959902180\";\n   PhraseSet response = adaptationClient.createPhraseSet(parent, phraseSet, phraseSetId);\n }\n </code></pre>"
   syntax:
     content: "package com.microsoft.samples"
   javaType: "package"