restored caveat with some wording changes

I re-ordered the phrasing to give the reader a sense of the big picture first. Also, I attempted to clarify the language about library vs application development. However, I am not sure if I captured the spirit of what was intended by those words by the previous author.

Author: mavaddat

source/tutorials/managing-dependencies.rst

@@ -26,6 +26,22 @@ as Python libraries, should also consider the
 `poetry <https://github.com/python-poetry/poetry>`_ project as an alternative dependency
 management solution.
 
+Recommendation caveats (circa June 2020)	
+-----------------------------------------	
+
+At present, the ``pipenv`` project team is `staging multiple bug fixes and features <https://github.com/pypa/pipenv/issues/3369>`_, so the tool continues to suffer from several quirks and performance problems. The latest updates are in pre-release stage after long hiatus in its project activity.
+
+Because of these issues, you may find you need to troubleshoot the tool itself. While this tutorial covers ``pipenv`` project as a tool for Python *application* development, the abovementioned troubleshooting may necessitate thinking of ``pipenv`` itself as a *library* in development. If you run into a bug that `appears to be addressed <https://github.com/pypa/pipenv/releases/latest>`_ by the latest preview version, you may want to try the `latest Pipenv <https://pypi.org/project/pipenv/#history>`_. In such a case, you may want to install the pre-release by specifying the version string in `pip` as follows:
+
+.. code-block:: python
+
+    pip install pipenv==2020.4.1b2
+
+Alternatively, project maintainers may want to investigate :ref:`other-dependency-management-tools` for use instead or	
+alongside ``pipenv``.
+
+The above caveat on the tutorial will remain until the most recent ``pipenv`` is a stable release.
+
 Installing Pipenv
 -----------------
 
@@ -41,12 +57,6 @@ Use ``pip`` to install Pipenv:
 
     pip install --user pipenv
 
-At present, the `latest Pipenv <https://pypi.org/project/pipenv/#history>`_ is in pre-release stage after a long hiatus. If you run into a bug that `appears to be addressed <https://github.com/pypa/pipenv/releases/latest>`_ by the latest preview version, you may want to try installing the pre-release by specifying the version in `pip` as follows:
-
-.. code-block:: python
-
-    pip install pipenv==2020.4.1b2
-
 .. _pipenv-user-base:
 
 .. Note:: This does a `user installation`_ to prevent breaking any system-wide