HyukjinKwon commented on a change in pull request #27928:
URL: https://github.com/apache/spark/pull/27928#discussion_r419238520
##########
File path: dev/README.md
##########
@@ -1,5 +1,20 @@
# Spark Developer Scripts
+
This directory contains scripts useful to developers when packaging,
testing, or committing to Spark.
Many of these scripts require Apache credentials to work correctly.
+
+## Managing Python-based Development Requirements
+
+* For local development, use `requirements.txt`.
+* For continuous integration and release engineering, use
`requirements-pinned.txt`.
+* `requirements-pinned.txt` is generated automatically from
`requirements.txt`, so don't update it by hand.
+
+ To update `requirements-pinned.txt`, use pip-tools:
Review comment:
No big deal but what about renaming it `requirements-frozen.txt`? It
reminds me of `pip freeze`. `requirements-pinned.txt` is okay too. Just saying
..
----------------------------------------------------------------
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]
