You are viewing a plain text version of this content. The canonical link for it is here.
Posted to reviews@spark.apache.org by "itholic (via GitHub)" <gi...@apache.org> on 2023/11/27 06:04:43 UTC
[PR] [SPARK-46116][DOCS][PYTHON] Adding "Q&A Support" and "Mailing Lists" link into PySpark doc homepage. [spark]
itholic opened a new pull request, #44033:
URL: https://github.com/apache/spark/pull/44033
### What changes were proposed in this pull request?
This PR proposes to enhance the PySpark documentation by adding more items for a "Useful links"including "Q&A Support", "Dev Mailing List" and the "User Mailing List".
### Why are the changes needed?
It is aimed at improving user engagement and providing quick access to community support and discussions. This approach is inspired by the [Pandas documentation](https://pandas.pydata.org/docs/index.html), which effectively uses a similar section for community engagement.
The "Q&A Support" will lead users to a curated list of StackOverflow questions tagged with `pyspark`, while the mailing lists will offer platforms for deeper discussions and insights within the Spark community.
### Does this PR introduce _any_ user-facing change?
No API change, but the main page of the PySpark documentation will be updated to include a new "Useful links"as below:
<img width="1303" alt="Screenshot 2023-11-27 at 2 49 24 PM" src="https://github.com/apache/spark/assets/44108233/db021fb1-c154-4556-91fb-06e2df00af81">
## Linked pages for each items
### Q&A Support
<img width="935" alt="Screenshot 2023-11-27 at 2 59 31 PM" src="https://github.com/apache/spark/assets/44108233/78deff80-ccc8-4969-9966-cb308ba2a71d">
### Dev Mailing List
<img width="1601" alt="Screenshot 2023-11-27 at 3 00 23 PM" src="https://github.com/apache/spark/assets/44108233/64b70a59-8120-47a7-94f4-4a4a6fe94e69">
### User Mailing List
<img width="1604" alt="Screenshot 2023-11-27 at 3 00 44 PM" src="https://github.com/apache/spark/assets/44108233/af77ef5d-c594-448d-ba7e-63d89d6e176c">
### How was this patch tested?
<!--
If tests were added, say they were added here. Please make sure to add some test cases that check the changes thoroughly including negative and positive cases if possible.
If it was tested in a way different from regular unit tests, please clarify how you tested step by step, ideally copy and paste-able, so that other reviewers can test and check, and descendants can verify in the future.
If tests were not added, please describe why they were not added and/or why it was difficult to add.
If benchmark tests were added, please run the benchmarks in GitHub Actions for the consistent environment, and the instructions could accord to: https://spark.apache.org/developer-tools.html#github-workflow-benchmarks.
-->
Manually build doc & verify each links.
### Was this patch authored or co-authored using generative AI tooling?
No.
--
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: reviews-unsubscribe@spark.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: reviews-unsubscribe@spark.apache.org
For additional commands, e-mail: reviews-help@spark.apache.org
Re: [PR] [SPARK-46116][DOCS][PYTHON] Adding "Q&A Support" and "Mailing Lists" link into PySpark doc homepage. [spark]
Posted by "yaooqinn (via GitHub)" <gi...@apache.org>.
yaooqinn commented on PR #44033:
URL: https://github.com/apache/spark/pull/44033#issuecomment-1827284033
Users generally prefer using platforms such as Slack or Stack Overflow. However, as an Apache project, user [mailing lists](https://www.apache.org/foundation/mailinglists#mailing-lists
) should be recommended for Q&A support.
So, how about renaming `Q&A support` to `Stack Overflow`.
--
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: reviews-unsubscribe@spark.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: reviews-unsubscribe@spark.apache.org
For additional commands, e-mail: reviews-help@spark.apache.org
Re: [PR] [SPARK-46116][DOCS][PYTHON] Adding "Stack Overflow" and "Mailing Lists" link into PySpark doc homepage. [spark]
Posted by "yaooqinn (via GitHub)" <gi...@apache.org>.
yaooqinn closed pull request #44033: [SPARK-46116][DOCS][PYTHON] Adding "Stack Overflow" and "Mailing Lists" link into PySpark doc homepage.
URL: https://github.com/apache/spark/pull/44033
--
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: reviews-unsubscribe@spark.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: reviews-unsubscribe@spark.apache.org
For additional commands, e-mail: reviews-help@spark.apache.org
Re: [PR] [SPARK-46116][DOCS][PYTHON] Adding "Stack Overflow" and "Mailing Lists" link into PySpark doc homepage. [spark]
Posted by "itholic (via GitHub)" <gi...@apache.org>.
itholic commented on PR #44033:
URL: https://github.com/apache/spark/pull/44033#issuecomment-1827347850
Thanks @yaooqinn ! Sounds reasonable to me. Applied the suggested name and related PR title & descriptions.
--
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: reviews-unsubscribe@spark.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: reviews-unsubscribe@spark.apache.org
For additional commands, e-mail: reviews-help@spark.apache.org
Re: [PR] [SPARK-46116][DOCS][PYTHON] Adding "Stack Overflow" and "Mailing Lists" link into PySpark doc homepage. [spark]
Posted by "yaooqinn (via GitHub)" <gi...@apache.org>.
yaooqinn commented on PR #44033:
URL: https://github.com/apache/spark/pull/44033#issuecomment-1828997442
Thank you. Merged to master
--
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: reviews-unsubscribe@spark.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: reviews-unsubscribe@spark.apache.org
For additional commands, e-mail: reviews-help@spark.apache.org
Re: [PR] [SPARK-46116][DOCS][PYTHON] Adding "Stack Overflow" and "Mailing Lists" link into PySpark doc homepage. [spark]
Posted by "itholic (via GitHub)" <gi...@apache.org>.
itholic commented on PR #44033:
URL: https://github.com/apache/spark/pull/44033#issuecomment-1829075788
Thanks for the review!
--
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: reviews-unsubscribe@spark.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: reviews-unsubscribe@spark.apache.org
For additional commands, e-mail: reviews-help@spark.apache.org