kojiromike commented on a change in pull request #847:
URL: https://github.com/apache/avro/pull/847#discussion_r419391638



##########
File path: doc/src/content/xdocs/spec.xml
##########
@@ -546,7 +546,7 @@
 
           <section id="union_encoding">
             <title>Unions</title>
-            <p>A union is encoded by first writing a <code>long</code>
+            <p>A union is encoded by first writing an <code>int</code>

Review comment:
       @anhldbk Agreed. I'm also asking you to add a similar note right here in 
the docs, either as a footnote with an asterisk, or with parentheses. Sure, 
we'll never see such a union in real life, but we should still document the 
state of the implementation(s) as they are. That is, for C and C++, practically 
an `int`, but theoretically a `long`.




----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org


Reply via email to