[GitHub] [arrow] pitrou commented on a diff in pull request #12938: ARROW-16256: [Docs] Document which format version is supported

[GitBox <gi...@apache.org>]

pitrou commented on code in PR #12938:
URL: https://github.com/apache/arrow/pull/12938#discussion_r855400210


##########
docs/source/status.rst:
##########
@@ -20,8 +20,9 @@ Implementation Status
 =====================
 
 The following tables summarize the features available in the various official
-Arrow libraries.  Unless otherwise stated, the Python, R, Ruby and C/GLib
-libraries follow the C++ Arrow library.
+Arrow libraries. All libraries currently follow version 1.0.0 of the Arrow
+format. See :ref:`status` for details about versioning. Unless otherwise stated,

Review Comment:
   Is this supposed to be creating a link to itself or am I misunderstanding this?



##########
docs/source/format/Versioning.rst:
##########
@@ -18,12 +18,13 @@
 Format Versioning and Stability
 ===============================
 
-Starting with version 1.0.0, Apache Arrow utilizes
+Starting with version 1.0.0, Apache Arrow uses
 **two versions** to describe each release of the project:
 the **Format Version** and the **Library Version**. Each Library
 Version has a corresponding Format Version, and multiple versions of
 the library may have the same format version. For example, library
-versions 2.0.0 and 3.0.0 may both track format version 1.0.0.
+versions 2.0.0 and 3.0.0 may both track format version 1.0.0. See
+:ref:`status` for details about supported features in each library.

Review Comment:
   The `ref` directive points to a logical anchor, but here I think you want to point to the document named "status":
   ```suggestion
   :doc:`status` for details about supported features in each library.
   ```



-- 
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: github-unsubscribe@arrow.apache.org

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