Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

clarified docs for env-vars and config files #13050

Open
wants to merge 5 commits into
base: main
Choose a base branch
from

Conversation

zerothi
Copy link

@zerothi zerothi commented Oct 27, 2024

More links between sections are added.
It should bring all documentation together
in a more coherent manner.

The Environemnt variables section has been
cleaned.
Now there are not 3 random examples which
might have confused users to only suspect that those 3 examples where the only available ones.
Now this section clarifies how any CLI-option
is specified through an env var, and clarifies
that the shell example, is an example.

@zerothi
Copy link
Author

zerothi commented Oct 27, 2024

This was born out of the discussion in #13043, hence the branch reference.

More links between sections are added.
It should bring all documentation together
in a more coherent manner.

The Environemnt variables section has been
cleaned.
Now there are not 3 *random* examples which
might have confused users to only suspect that those
3 examples where the only available ones.
Now this section clarifies how *any* CLI-option
is specified through an env var, and clarifies
that the shell example, *is* an example.

Signed-off-by: Nick Papior <nickpapior@gmail.com>
Signed-off-by: Nick Papior <nickpapior@gmail.com>
@zerothi zerothi force-pushed the 13043-docs-env-vars branch from dc77343 to 627a1ae Compare October 27, 2024 19:24
@ichard26 ichard26 self-requested a review December 12, 2024 21:33
@ichard26 ichard26 added the type: docs Documentation related label Dec 12, 2024
Copy link
Member

@ichard26 ichard26 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry for long delay. Improvements to pip's documentation are appreciated. I like where this is going, but I do think this needs some tweaking.

docs/html/topics/configuration.md Outdated Show resolved Hide resolved
docs/html/topics/configuration.md Outdated Show resolved Hide resolved
docs/html/topics/configuration.md Show resolved Hide resolved
docs/html/topics/configuration.md Outdated Show resolved Hide resolved
docs/html/topics/configuration.md Outdated Show resolved Hide resolved
docs/html/topics/configuration.md Outdated Show resolved Hide resolved
docs/html/topics/configuration.md Outdated Show resolved Hide resolved
docs/html/topics/configuration.md Outdated Show resolved Hide resolved
@ichard26 ichard26 added the skip news Does not need a NEWS file entry (eg: trivial changes) label Dec 16, 2024
Copy link
Member

@ichard26 ichard26 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for your patience!

@zerothi
Copy link
Author

zerothi commented Dec 17, 2024

Great! Looks complete to me!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bot:chronographer:provided skip news Does not need a NEWS file entry (eg: trivial changes) type: docs Documentation related
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants