Editable vs. -e?

[henryiii]

I've noticed the fully-written-out version the editable flag, pip install --editable ".[test]", being used. I've pretty much never seen this, even in CI, where it's usually advised to use long-form flags. Given it's something you tend to run a lot (say for compiled code, where you need to rebuild, or just in general every time you make a venv), wouldn't it be better to use the common form, pip install -e ".[test]", and just mention it has a long --editable version instead?

Note that git commit -m is used, not git commit --message.

[hollandjg]

I think that the long-form reduces the cognitive load, and that's something we need to do as much as possible given the material and the short time we have.

(I'd honestly not noticed that -m because I've used it for years and it's obvious to me, but I think that's something I need to be more careful of. There were other sessions which touched on git so I think we'll just leave that – I think everyone will understand -m, whereas -e/--editable is completely new.)

We mention the --editable/-e equivalency the first time the flag is used, and I think we'll keep it that way for tomorrow.

There's no reason not to change it back if that's preferable after we've given this year's workshop!