HyukjinKwon opened a new pull request #29491:
URL: https://github.com/apache/spark/pull/29491


   ### What changes were proposed in this pull request?
   
   This PR proposes to:
   - add a notebook with a Binder integration which allows users to try PySpark 
in a live notebook. Please [try this 
here](https://mybinder.org/v2/gh/HyukjinKwon/spark/SPARK-32204?filepath=python%2Fdocs%2Fsource%2Fgetting_started%2Fquickstart.ipynb).
   - reuse this notebook as a quickstart guide in PySpark API documentation.
   
   Note that Binder turns a Git repo into a collection of interactive 
notebooks. It works based on Docker image. Once somebody builds, other people 
can reuse the image against a specific commit.
   Therefore, if we run Binder with the images based on released tags in Spark, 
virtually all users can instantly launch the Jupyter notebooks.
   
   I made a simple demo to make it easier to review. Please see:
   - [Main page](https://hyukjin-spark.readthedocs.io/en/stable/). Note that 
the link ("Live Notebook") in the main page wouldn't work since this PR is not 
merged yet.
   - [Quickstart 
page](https://hyukjin-spark.readthedocs.io/en/stable/getting_started/quickstart.html)
   
   When reviewing the notebook file itself, I think it will be easier if you:
   - open 
[here](https://mybinder.org/v2/gh/HyukjinKwon/spark/SPARK-32204?filepath=python%2Fdocs%2Fsource%2Fgetting_started%2Fquickstart.ipynb).
   - upload here in a GitHub comment. Then, I will push a commit with crediting 
correctly.
   - alternatively, push a commit into this PR right away (if you're a 
committer).
   
   ### Why are the changes needed?
   
   To improve PySpark's usability. The current quickstart for Python users are 
very friendly.
   
   ### Does this PR introduce _any_ user-facing change?
   
   Yes, it will add a documentation page, and expose a live notebook to PySpark 
users.
   
   ### How was this patch tested?
   
   
   
   Manually tested, and GitHub Actions builds will test.


----------------------------------------------------------------
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.

For queries about this service, please contact Infrastructure at:
[email protected]



---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to