kaxil commented on a change in pull request #8513:
URL: https://github.com/apache/airflow/pull/8513#discussion_r412925344
##########
File path: docs/installation.rst
##########
@@ -23,17 +23,31 @@ Installation
Getting Airflow
'''''''''''''''
-The easiest way to install the latest stable version of Airflow is with
``pip``:
+Airflow is published as ``apache-airflow`` package in PyPi. Installing it
however might be sometimes tricky
+because Airflow is a bit of both a library and application. Libraries usually
keep their dependencies open and
+Applications usually pin them but we should do neither and both at the same
time. We decided to keep
+our dependencies as open as possible (in setup.py) so users are not limited to
certain versions of
+dependencies. This means that from time to time ``pip install apache-airflow``
will not work or will
+produce unusable Airflow installation.
+
+In order to have repeatable installation, however starting from Airlfow
1.10.10 we also keep a set of
+"known-to-be-working" requirements.txt in the requirements folder. Those
"known-to-be-working"
+requirements are per Major/Minor python version and you can use them as
constraint files when installing
+Airflow from PyPi as follows (note that you have to specify correct Airflow
version and python versions
Review comment:
```suggestion
Airflow from PyPI as follows (note that you have to specify correct Airflow
version and python versions
```
----------------------------------------------------------------
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]
