wjones127 commented on code in PR #13859: URL: https://github.com/apache/arrow/pull/13859#discussion_r975782828
########## docs/source/cpp/getting_started.rst: ########## @@ -18,28 +18,29 @@ .. default-domain:: cpp .. highlight:: cpp -User Guide -========== +Getting Started +=============== + +The following articles exist to enable installation, use, and a basic understanding of Arrow. +Specifically, it contains: an installation and linking guide; documentation of conventions used +in the codebase and suggested for users; and tutorials, including: + +* Using Arrow data structures +* Using Arrow's file I/O utilities +* Using Arrow's efficient computation tools +* Utilizing partitioned datasets with Arrow Review Comment: I'm thinking the audience here is people who don't yet know much about Arrow, so we should be specific and not assume familiarity. (For example "Using Arrow data structure" -> "What data structures does arrow have?" -> "Building Arrow arrays and tabular structures".) ```suggestion * Building Arrow arrays and tabular structures * Reading and writing Parquet, Arrow, and CSV files * Executing compute kernels on arrays * Reading and writing multi-file partitioned datasets ``` ########## docs/source/cpp/getting_started.rst: ########## @@ -18,28 +18,29 @@ .. default-domain:: cpp .. highlight:: cpp -User Guide -========== +Getting Started +=============== + +The following articles exist to enable installation, use, and a basic understanding of Arrow. Review Comment: ```suggestion The following articles demonstrate installation, use, and a basic understanding of Arrow. These articles will get you setup quickly using Arrow and give you a taste of what the library is capable of. ``` -- 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]
