Nlte opened a new pull request #2:
URL: https://github.com/apache/arrow-cookbook/pull/2


   Hi, I have started playing with the cookbook examples and there is a little 
doc section that I did not find clear hence here this PR.
   
   ### Issue
   The **testsetup::** blocs in the rst files are not written out in the 
resulting HTML.
   In the "Given an array with 100 numbers, from 0 to 99" sections the **arr** 
object pops up ex nihilo in the documentation which might lose the reader a bit 
even though most people will guess the np.arange here.
   
   ### Proposed solution
   Add the array creation code in the testcode:: blocs for those sections 
section to make it more explicit.
   
   That is going from
   ```
   Given an array with 100 numbers, from 0 to 99
   
   print(f"{arr[0]} .. {arr[-1]}")
   
   0 .. 99
   ```
   
   to
   
   ```
   Given an array with 100 numbers, from 0 to 99
   
   import numpy as np
   import pyarrow as pa
   
   arr = pa.array(np.arange(100))
   
   print(f"{arr[0]} .. {arr[-1]}")
   
   0 .. 99
   ```
   
   Thanks,
   Nathanaƫl
   


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

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


Reply via email to