Merge pull request #1862 from python-poetry/docs/no-root

Document --no-root

docs/docs/basic-usage.md

@@ -134,6 +134,15 @@ the dependencies installed are still working even if your dependencies released
 
 
     For libraries it is not necessary to commit the lock file.
     For libraries it is not necessary to commit the lock file.
 
 
+### Installing dependencies only
+
+The current project is installed in [editable](https://pip.pypa.io/en/stable/reference/pip_install/#editable-installs) mode by default.
+
+If you want to install the dependencies only, run the `install` command with the `--no-root` flag:
+
+```bash
+poetry install --no-root
+```
 
 
 ## Updating dependencies to their latest versions
 ## Updating dependencies to their latest versions
 
 

poetry/console/commands/install.py

@@ -34,6 +34,12 @@ libraries and dependencies outlined in that file. If the file does not
 exist it will look for <comment>pyproject.toml</> and do the same.
 exist it will look for <comment>pyproject.toml</> and do the same.
 
 
 <info>poetry install</info>
 <info>poetry install</info>
+
+By default, the above command will also install the current project. To install only the
+dependencies and not including the current project, run the command with the
+<info>--no-root</info> option like below:
+
+<info> poetry install --no-root</info>
 """
 """
 
 
     _loggers = ["poetry.repositories.pypi_repository"]
     _loggers = ["poetry.repositories.pypi_repository"]