timgrein opened a new pull request, #45112:
URL: https://github.com/apache/arrow/pull/45112

   ### Rationale for this change
   
   In the intro docs ("Overview of Arrow Terminology" section) the sentence 
`[...]A Field includes a field name, a data type, a nullability flag and 
optional key-value metadata for a specific column in a RecordBatch.[...]` is 
positioned in a non-consistent way compared to others. This felt a bit 
confusing in the beginning as I thought, that either the term, which should be 
described is missing or that the sentence should belong to `Schema`.
   
   <img width="736" alt="image" 
src="https://github.com/user-attachments/assets/afac4db0-10a8-46e7-a384-80faffad2334";
 />
   (Here you can see that the sentence from above is positioned in a way 
implying that it also describes an Arrow term on its own)
   
   I think it should come right after `Schemas can contain optional key/value 
metadata.` as it still belongs to the `Schema` description AFAIU.
   
   ### What changes are included in this PR?
   
   Removing a new-line to make it clear to which the term the sentence belongs 
to.
   
   ### Are these changes tested?
   
   No, as this is only a docs change.
   
   ### Are there any user-facing changes?
   
   No, as this is only a docs change.
   


-- 
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.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to