Display env vars for pip options in docs

[luismedel]

Close #8044

This PR contains the same changes as #11993 by @ctg123 but with the missing type hints.

I decided to create a new PR to simplify the merge.

Close #11993

[uranusjr]

Would you mind referencing @ctg123 as the author in the initial commit as well so he shows up as a contributor? This can be done with

$ git rebase -i main  # And change the action on the initial commit from "pick" to "edit".
$ git commit --amend --author="ctg123 <[email protected]>" --no-edit
$ git rebase --continue

[webknjaz]

@luismedel could you use full sentences in the changelog fragment? It'd also be nice to drop the imperative mood since a changelog is less of an instruction list and more like a news digest with what's changed since the previous release.

Looking good otherwise!

[luismedel]

@luismedel could you use full sentences in the changelog fragment? It'd also be nice to drop the imperative mood since a changelog is less of an instruction list and more like a news digest with what's changed since the previous release.

Looking good otherwise!

Thanks. I tried to better clarify the change.

What I'm not really sure is how to escape the imperative mood if the message should continue the "This change will..." idiom, as per the guidelines :-(

[pfmoore]

Stick to the guidelines - the news entry looks fine to me (with one minor grammar nit). Not using imperative mood for news entries isn't a principle we use on pip.

[webknjaz]

Ah, I didn't realize. Wonder why..

[webknjaz]

@luismedel it's not explicitly called out, but if you look into the old changelogs, most of the entries are full sentences with a trailing period. Might be worth fixing?

[luismedel]

@luismedel it's not explicitly called out, but if you look into the old changelogs, most of the entries are full sentences with a trailing period. Might be worth fixing?

@webknjaz sure!

[pfmoore]

Thanks for the PR!