danepitkin commented on code in PR #36591: URL: https://github.com/apache/arrow/pull/36591#discussion_r1323324014
########## docs/source/index.rst: ########## @@ -35,11 +37,216 @@ such topics as: **To learn how to use Arrow refer to the documentation specific to your target environment.** +.. grid:: 2 + :gutter: 4 + :padding: 2 2 0 0 + :class-container: sd-text-center + + .. grid-item-card:: Format + :class-card: contrib-card + :shadow: none + + Read about the Apache Arrow format + specifications and protocols. + + +++ + + .. button-ref:: format + :ref-type: ref + :click-parent: + :color: primary + :expand: + + To the specifications + + .. grid-item-card:: Developing + :class-card: contrib-card + :shadow: none + + Find the documentation on the topic of + contributions, reviews, building of the libraries + from source, building of the documentation, + continuous integration, benchmarks and the + release process. + + +++ + + .. button-ref:: developers + :ref-type: ref + :click-parent: + :color: primary + :expand: + + To the documentation + +Supported environments +---------------------- + +.. grid:: auto + + .. grid-item:: + + .. button-ref:: c-glib + :ref-type: ref + :color: info + :shadow: + + C/GLib + + .. grid-item:: + + .. button-ref:: cpp + :ref-type: ref + :color: info + :expand: + + C++ + + .. grid-item:: + + .. button-link:: https://github.com/apache/arrow/blob/main/csharp/README.md + :color: info + :expand: + + C# + + .. grid-item:: + + .. button-link:: https://pkg.go.dev/github.com/apache/arrow/go + :color: info + :expand: + + Go + + .. grid-item:: + + .. button-ref:: java + :ref-type: ref + :color: info + :expand: + + Java + + .. grid-item:: + + .. button-ref:: js + :ref-type: ref + :color: info + :expand: + + JavaScript + + .. grid-item:: + + .. button-link:: https://arrow.apache.org/julia/ + :color: info + :expand: + + Julia + + .. grid-item:: + + .. button-link:: https://github.com/apache/arrow/blob/main/matlab/README.md + :ref-type: ref + :color: info + :expand: + + Matlab + + .. grid-item:: + + .. button-ref:: python + :ref-type: ref + :color: info + :expand: + + Python + + .. grid-item:: + + .. button-ref:: r + :ref-type: ref + :color: info + :expand: + + R + + .. grid-item:: + + .. button-link:: https://github.com/apache/arrow/blob/main/ruby/README.md + :color: info + :expand: + + Ruby + + .. grid-item:: + + .. button-link:: https://docs.rs/crate/arrow/ + :color: info + :expand: + + Rust + +`Implementation Status for all of the languages <status>`_ Review Comment: This link is broken for me ########## docs/source/index.rst: ########## @@ -35,11 +37,216 @@ such topics as: **To learn how to use Arrow refer to the documentation specific to your target environment.** +.. grid:: 2 + :gutter: 4 + :padding: 2 2 0 0 + :class-container: sd-text-center + + .. grid-item-card:: Format + :class-card: contrib-card + :shadow: none + + Read about the Apache Arrow format + specifications and protocols. + + +++ + + .. button-ref:: format + :ref-type: ref + :click-parent: + :color: primary + :expand: + + To the specifications + + .. grid-item-card:: Developing + :class-card: contrib-card + :shadow: none + + Find the documentation on the topic of + contributions, reviews, building of the libraries + from source, building of the documentation, + continuous integration, benchmarks and the + release process. + + +++ + + .. button-ref:: developers + :ref-type: ref + :click-parent: + :color: primary + :expand: + + To the documentation + +Supported environments Review Comment: I would prefer to see the landing page focus on "Getting Started" first, "Language Implementations" second, "Examples" third, "Specification" fourth, and "Contributing" fifth. Essentially, I think we should optimize for users over contributors/developers. ########## docs/source/cpp/index.rst: ########## @@ -27,7 +29,7 @@ Welcome to the Apache Arrow C++ implementation documentation! .. grid-item-card:: Basic understanding Review Comment: Optional: I know this is not part of your diff, but I would prefer to see the grid item match the section name. e.g. `Basic understanding` -> `Getting started`, `Examples of use` -> `Examples`. The "button" inside the box could say `to Getting Started` and `to Examples` (or just remove it if that's preferred) -- 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]
