maxpoletaev opened a new issue, #269:
URL: https://github.com/apache/arrow-go/issues/269

   Don't get me wrong, this is an incredible piece of software, and the 
platform-specific optimizations and complexity it handles are very impressive - 
mad respect to everyone involved in building it.
   
   I do, however, find myself struggling with the API's learning curve to the 
point that it makes me feel very dumb and frustrated every time I want to read 
a few parquet files.
   
   Currently, I rely exclusively on `pqarrow/*_test.go` files as my primary 
reference to understand usage patterns, which doesn't seem like the proper 
place to learn. The godoc, while being comprehensive, covers so many types and 
subpackages that it's hard to piece together a clear picture of how everything 
fits together.
   
   I suspect other people might be hitting the same wall. The gap between 
understanding the API documentation and actually implementing something feels 
unusually wide here compared to other packages in the Go ecosystem. 
   
   I thought that maybe adding some foundational examples in the README or the 
main godoc page could make a huge difference in helping devs get over that 
initial hump and make the project appear more approachable.


-- 
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: issues-unsubscr...@arrow.apache.org.apache.org

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

Reply via email to