Pip module editable flag

Hi,

I'm very confused about the 'editable' parameter for the pip module
[1]. It defaults to True and is described as "Pass the editable flag
for versioning URLs." My best guess is that this corresponds to the
--editable option for 'pip install' [2], however:

- The pip install --editable option effectively enables Setuptools'
"develop mode" which links to module code instead of building and
installing it - I'm not sure how that relates to the description of
passing the editable flag for versioning URLs.
- "Editable" installs are not the default for Pip's package
installations, so a default enablement of this option in the Ansible
pip module seems to conflict with the default disablement in the
underlying tool.

Can this option be expounded on? Does the module's 'editable'
parameter relate to the pip install option, and is the naming
confusing or is the description just odd? Why is the parameter True by
default?

[1] http://docs.ansible.com/ansible/pip_module.html
[2] https://pip.pypa.io/en/stable/reference/pip_install/

Kind regards,