address review, I think?
@@ -1002,9 +1002,11 @@ Examples
.. note::
- This will only update ``SomePackage`` as it is a direct requirement. Any
- of its dependencies (indirect requirements) will be affected by the
- ``--upgrade-strategy`` command.
+ This will guarantee an update to ``SomePackage`` as it is a direct
+ requirement, and possibly upgrade dependencies if their installed
+ versions do not meet the minimum requirements of ``SomePackage``.
+ Any non-requisite updates of its dependencies (indirect requirements)
+ will be affected by the ``--upgrade-strategy`` command.
#. Install a local project in "editable" mode. See the section on :ref:`Editable Installs <editable-installs>`.
