You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@spark.apache.org by ur...@apache.org on 2026/09/09 11:38:49 UTC

(spark) branch branch-4.x updated: [SPARK-59363][DOC] Fix ungrammatical 'allows to' in the Avro data source doc

This is an automated email from the ASF dual-hosted git repository.

uros-b pushed a commit to branch branch-4.x
in repository https://gitbox.apache.org/repos/asf/spark.git


The following commit(s) were added to refs/heads/branch-4.x by this push:
     new 31099c3787bc [SPARK-59363][DOC] Fix ungrammatical 'allows to' in the Avro data source doc
31099c3787bc is described below

commit 31099c3787bc1d85635dac3cc7ebcc4afb70b92c
Author: Uros <22...@users.noreply.github.com>
AuthorDate: Wed Sep 9 11:38:23 2026 +0000

    [SPARK-59363][DOC] Fix ungrammatical 'allows to' in the Avro data source doc
    
    ### What changes were proposed in this pull request?
    
    Four option descriptions in `docs/sql-data-sources-avro.md` use the ungrammatical phrasing "the option allows to &lt;verb&gt;" -- for the `compression`, `mode`, and `datetimeRebaseMode` options and the Avro Union-type field-prefix option. This changes them to "allows you to &lt;verb&gt;".
    
    ### Why are the changes needed?
    
    "allows to &lt;verb&gt;" is not grammatical; "allows you to &lt;verb&gt;" reads correctly and matches the phrasing used elsewhere in the docs.
    
    ### Does this PR introduce _any_ user-facing change?
    
    No. Documentation only.
    
    ### How was this patch tested?
    
    N/A -- documentation-only change.
    
    ### Was this patch authored or co-authored using generative AI tooling?
    
    Generated-by: Claude Code (Opus 4.8)
    
    Closes #58654 from uros-b/fix-avro-docs-allows-to.
    
    Authored-by: Uros <22...@users.noreply.github.com>
    Signed-off-by: Uros Bojanic <22...@users.noreply.github.com>
    (cherry picked from commit ce20273c2faa8323e8a15d919eab3f4ebe3e0f2f)
    Signed-off-by: Uros Bojanic <22...@users.noreply.github.com>
---
 docs/sql-data-sources-avro.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/sql-data-sources-avro.md b/docs/sql-data-sources-avro.md
index e786e7f2b9ef..8146ce34b235 100644
--- a/docs/sql-data-sources-avro.md
+++ b/docs/sql-data-sources-avro.md
@@ -299,7 +299,7 @@ Data source options of Avro can be set via:
   <tr>
     <td><code>compression</code></td>
     <td>snappy</td>
-    <td>The <code>compression</code> option allows to specify a compression codec used in write.<br>
+    <td>The <code>compression</code> option allows you to specify a compression codec used in write.<br>
   Currently supported codecs are <code>uncompressed</code>, <code>snappy</code>, <code>deflate</code>, <code>bzip2</code>, <code>xz</code> and <code>zstandard</code>.<br> If the option is not set, the configuration <code>spark.sql.avro.compression.codec</code> config is taken into account.</td>
     <td>write</td>
     <td>2.4.0</td>
@@ -307,7 +307,7 @@ Data source options of Avro can be set via:
   <tr>
     <td><code>mode</code></td>
     <td>FAILFAST</td>
-    <td>The <code>mode</code> option allows to specify parse mode for function <code>from_avro</code>.<br>
+    <td>The <code>mode</code> option allows you to specify parse mode for function <code>from_avro</code>.<br>
       Currently supported modes are:
       <ul>
         <li><code>FAILFAST</code>: Throws an exception on processing corrupted record.</li>
@@ -321,7 +321,7 @@ Data source options of Avro can be set via:
   <tr>
     <td><code>datetimeRebaseMode</code></td>
     <td>(value of <code>spark.sql.avro.datetimeRebaseModeInRead</code> configuration)</td>
-    <td>The <code>datetimeRebaseMode</code> option allows to specify the rebasing mode for the values of the <code>date</code>, <code>timestamp-micros</code>, <code>timestamp-millis</code> logical types from the Julian to Proleptic Gregorian calendar.<br>
+    <td>The <code>datetimeRebaseMode</code> option allows you to specify the rebasing mode for the values of the <code>date</code>, <code>timestamp-micros</code>, <code>timestamp-millis</code> logical types from the Julian to Proleptic Gregorian calendar.<br>
       Currently supported modes are:
       <ul>
         <li><code>EXCEPTION</code>: fails in reads of ancient dates/timestamps that are ambiguous between the two calendars.</li>
@@ -349,7 +349,7 @@ Data source options of Avro can be set via:
   <tr>
     <td><code>stableIdentifierPrefixForUnionType</code></td>
     <td>member_</td>
-    <td>When `enableStableIdentifiersForUnionType` is enabled, the option allows to configure the prefix for fields of Avro Union type.</td>
+    <td>When `enableStableIdentifiersForUnionType` is enabled, the option allows you to configure the prefix for fields of Avro Union type.</td>
     <td>read</td>
     <td>4.0.0</td>
   </tr>


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@spark.apache.org
For additional commands, e-mail: commits-help@spark.apache.org