From bb48f2eb5d3f7cbf7fbd6f9b59280dc397e9c105 Mon Sep 17 00:00:00 2001
From: Jonathan Peppers <jonathan.peppers@microsoft.com>
Date: Fri, 14 Aug 2026 05:51:23 -0500
Subject: [PATCH 1/2] Document translation response value APIs

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
---
 .../TranslationResponseValue+Builder.xml      | 98 +++++++++++++++----
 .../TranslationResponseValue.xml              | 37 +++++--
 2 files changed, 109 insertions(+), 26 deletions(-)

diff --git a/docs/xml/Android.Views.Translation/TranslationResponseValue+Builder.xml b/docs/xml/Android.Views.Translation/TranslationResponseValue+Builder.xml
index 9ef36af09..7cee9b028 100644
--- a/docs/xml/Android.Views.Translation/TranslationResponseValue+Builder.xml
+++ b/docs/xml/Android.Views.Translation/TranslationResponseValue+Builder.xml
@@ -184,10 +184,22 @@
         <Parameter Name="value" Type="Android.OS.Bundle" />
       </Parameters>
       <Docs>
-        <param name="value">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="value">Extra results associated with the translated text.</param>
+        <summary>Sets extra results associated with the translated text.</summary>
+        <remarks>
+          <para>Extra results associated with the translated text.</para>
+          <para>The bundle includes <c>#EXTRA_DEFINITIONS</c>, obtained by <c>Bundle#getBundle</c>.</para>
+          <para>
+            <format type="text/html">
+              <a href="https://developer.android.com/reference/android/view/translation/TranslationResponseValue.Builder#setExtras(android.os.Bundle)" title="Reference documentation">Java documentation for <code>android.view.translation.TranslationResponseValue.Builder.setExtras(android.os.Bundle)</code>.</a>
+            </format>
+          </para>
+          <para>
+                    Portions of this page are modifications based on work created and shared by the
+                    <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format>
+                     and used according to terms described in the
+                    <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="SetText">
@@ -217,10 +229,21 @@
         <Parameter Name="value" Type="Java.Lang.ICharSequence" />
       </Parameters>
       <Docs>
-        <param name="value">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="value">The translated text result.</param>
+        <summary>Sets the translated text result.</summary>
+        <remarks>
+          <para>The translated text result.</para>
+          <para>
+            <format type="text/html">
+              <a href="https://developer.android.com/reference/android/view/translation/TranslationResponseValue.Builder#setText(java.lang.CharSequence)" title="Reference documentation">Java documentation for <code>android.view.translation.TranslationResponseValue.Builder.setText(java.lang.CharSequence)</code>.</a>
+            </format>
+          </para>
+          <para>
+                    Portions of this page are modifications based on work created and shared by the
+                    <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format>
+                     and used according to terms described in the
+                    <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="SetText">
@@ -246,10 +269,21 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <param name="value">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="value">The translated text result.</param>
+        <summary>Sets the translated text result.</summary>
+        <remarks>
+          <para>The translated text result.</para>
+          <para>
+            <format type="text/html">
+              <a href="https://developer.android.com/reference/android/view/translation/TranslationResponseValue.Builder#setText(java.lang.CharSequence)" title="Reference documentation">Java documentation for <code>android.view.translation.TranslationResponseValue.Builder.setText(java.lang.CharSequence)</code>.</a>
+            </format>
+          </para>
+          <para>
+                    Portions of this page are modifications based on work created and shared by the
+                    <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format>
+                     and used according to terms described in the
+                    <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="SetTransliteration">
@@ -279,10 +313,22 @@
         <Parameter Name="value" Type="Java.Lang.ICharSequence" />
       </Parameters>
       <Docs>
-        <param name="value">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="value">The transliteration result of the translated text.</param>
+        <summary>Sets the transliteration result of the translated text.</summary>
+        <remarks>
+          <para>The transliteration result of the translated text.</para>
+          <para>This returns a CharSequence representation of the transliteration of the translated text.</para>
+          <para>
+            <format type="text/html">
+              <a href="https://developer.android.com/reference/android/view/translation/TranslationResponseValue.Builder#setTransliteration(java.lang.CharSequence)" title="Reference documentation">Java documentation for <code>android.view.translation.TranslationResponseValue.Builder.setTransliteration(java.lang.CharSequence)</code>.</a>
+            </format>
+          </para>
+          <para>
+                    Portions of this page are modifications based on work created and shared by the
+                    <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format>
+                     and used according to terms described in the
+                    <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="SetTransliteration">
@@ -308,10 +354,22 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <param name="value">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="value">The transliteration result of the translated text.</param>
+        <summary>Sets the transliteration result of the translated text.</summary>
+        <remarks>
+          <para>The transliteration result of the translated text.</para>
+          <para>This returns a CharSequence representation of the transliteration of the translated text.</para>
+          <para>
+            <format type="text/html">
+              <a href="https://developer.android.com/reference/android/view/translation/TranslationResponseValue.Builder#setTransliteration(java.lang.CharSequence)" title="Reference documentation">Java documentation for <code>android.view.translation.TranslationResponseValue.Builder.setTransliteration(java.lang.CharSequence)</code>.</a>
+            </format>
+          </para>
+          <para>
+                    Portions of this page are modifications based on work created and shared by the
+                    <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format>
+                     and used according to terms described in the
+                    <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="ThresholdClass">
diff --git a/docs/xml/Android.Views.Translation/TranslationResponseValue.xml b/docs/xml/Android.Views.Translation/TranslationResponseValue.xml
index a0d9acdbd..415d92b5c 100644
--- a/docs/xml/Android.Views.Translation/TranslationResponseValue.xml
+++ b/docs/xml/Android.Views.Translation/TranslationResponseValue.xml
@@ -461,9 +461,21 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <summary>The translated text result.</summary>
+        <value>The translated text result.</value>
+        <remarks>
+          <para>The translated text result.</para>
+          <para>
+            <format type="text/html">
+              <a href="https://developer.android.com/reference/android/view/translation/TranslationResponseValue#getText()" title="Reference documentation">Java documentation for <code>android.view.translation.TranslationResponseValue.getText()</code>.</a>
+            </format>
+          </para>
+          <para>
+                    Portions of this page are modifications based on work created and shared by the
+                    <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format>
+                     and used according to terms described in the
+                    <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="TextFormatted">
@@ -593,9 +605,22 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <summary>The transliteration result of the translated text.</summary>
+        <value>The transliteration result of the translated text.</value>
+        <remarks>
+          <para>The transliteration result of the translated text.</para>
+          <para>This returns a CharSequence representation of the transliteration of the translated text.</para>
+          <para>
+            <format type="text/html">
+              <a href="https://developer.android.com/reference/android/view/translation/TranslationResponseValue#getTransliteration()" title="Reference documentation">Java documentation for <code>android.view.translation.TranslationResponseValue.getTransliteration()</code>.</a>
+            </format>
+          </para>
+          <para>
+                    Portions of this page are modifications based on work created and shared by the
+                    <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format>
+                     and used according to terms described in the
+                    <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="TransliterationFormatted">

From 93cdcbec7f60277c953bc35ef734a902c8aac9a4 Mon Sep 17 00:00:00 2001
From: Jonathan Peppers <jonathan.peppers@microsoft.com>
Date: Fri, 14 Aug 2026 06:02:17 -0500
Subject: [PATCH 2/2] Address translation documentation review

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
---
 .../TranslationResponseValue+Builder.xml             | 12 +++++++++---
 .../TranslationResponseValue.xml                     |  1 -
 2 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/docs/xml/Android.Views.Translation/TranslationResponseValue+Builder.xml b/docs/xml/Android.Views.Translation/TranslationResponseValue+Builder.xml
index 7cee9b028..29e1601ef 100644
--- a/docs/xml/Android.Views.Translation/TranslationResponseValue+Builder.xml
+++ b/docs/xml/Android.Views.Translation/TranslationResponseValue+Builder.xml
@@ -186,9 +186,11 @@
       <Docs>
         <param name="value">Extra results associated with the translated text.</param>
         <summary>Sets extra results associated with the translated text.</summary>
+        <returns>This builder instance.</returns>
         <remarks>
           <para>Extra results associated with the translated text.</para>
-          <para>The bundle includes <c>#EXTRA_DEFINITIONS</c>, obtained by <c>Bundle#getBundle</c>.</para>
+          <para>The bundle includes <c>TranslationResponseValue.ExtraDefinitions</c>, obtained by
+            <c>Bundle.GetBundle(string)</c>.</para>
           <para>
             <format type="text/html">
               <a href="https://developer.android.com/reference/android/view/translation/TranslationResponseValue.Builder#setExtras(android.os.Bundle)" title="Reference documentation">Java documentation for <code>android.view.translation.TranslationResponseValue.Builder.setExtras(android.os.Bundle)</code>.</a>
@@ -231,6 +233,7 @@
       <Docs>
         <param name="value">The translated text result.</param>
         <summary>Sets the translated text result.</summary>
+        <returns>This builder instance.</returns>
         <remarks>
           <para>The translated text result.</para>
           <para>
@@ -271,6 +274,7 @@
       <Docs>
         <param name="value">The translated text result.</param>
         <summary>Sets the translated text result.</summary>
+        <returns>This builder instance.</returns>
         <remarks>
           <para>The translated text result.</para>
           <para>
@@ -315,9 +319,10 @@
       <Docs>
         <param name="value">The transliteration result of the translated text.</param>
         <summary>Sets the transliteration result of the translated text.</summary>
+        <returns>This builder instance.</returns>
         <remarks>
           <para>The transliteration result of the translated text.</para>
-          <para>This returns a CharSequence representation of the transliteration of the translated text.</para>
+          <para>The value represents the transliteration of the translated text.</para>
           <para>
             <format type="text/html">
               <a href="https://developer.android.com/reference/android/view/translation/TranslationResponseValue.Builder#setTransliteration(java.lang.CharSequence)" title="Reference documentation">Java documentation for <code>android.view.translation.TranslationResponseValue.Builder.setTransliteration(java.lang.CharSequence)</code>.</a>
@@ -356,9 +361,10 @@
       <Docs>
         <param name="value">The transliteration result of the translated text.</param>
         <summary>Sets the transliteration result of the translated text.</summary>
+        <returns>This builder instance.</returns>
         <remarks>
           <para>The transliteration result of the translated text.</para>
-          <para>This returns a CharSequence representation of the transliteration of the translated text.</para>
+          <para>The value represents the transliteration of the translated text.</para>
           <para>
             <format type="text/html">
               <a href="https://developer.android.com/reference/android/view/translation/TranslationResponseValue.Builder#setTransliteration(java.lang.CharSequence)" title="Reference documentation">Java documentation for <code>android.view.translation.TranslationResponseValue.Builder.setTransliteration(java.lang.CharSequence)</code>.</a>
diff --git a/docs/xml/Android.Views.Translation/TranslationResponseValue.xml b/docs/xml/Android.Views.Translation/TranslationResponseValue.xml
index 415d92b5c..6ba60bd37 100644
--- a/docs/xml/Android.Views.Translation/TranslationResponseValue.xml
+++ b/docs/xml/Android.Views.Translation/TranslationResponseValue.xml
@@ -609,7 +609,6 @@
         <value>The transliteration result of the translated text.</value>
         <remarks>
           <para>The transliteration result of the translated text.</para>
-          <para>This returns a CharSequence representation of the transliteration of the translated text.</para>
           <para>
             <format type="text/html">
               <a href="https://developer.android.com/reference/android/view/translation/TranslationResponseValue#getTransliteration()" title="Reference documentation">Java documentation for <code>android.view.translation.TranslationResponseValue.getTransliteration()</code>.</a>