Skip to content

docs: clarify when to pull Quay.io image vs build locally#2404

Merged
mathbunnyru merged 3 commits intojupyter:mainfrom
CoderLink06:docs-clarify-pull-vs-build
Jan 27, 2026
Merged

docs: clarify when to pull Quay.io image vs build locally#2404
mathbunnyru merged 3 commits intojupyter:mainfrom
CoderLink06:docs-clarify-pull-vs-build

Conversation

@CoderLink06
Copy link
Contributor

This PR adds a short clarification to help new users decide when to pull an existing image from Quay.io versus when to build a custom image locally.

It is based on the discussion in issue #2395 and aims to make the image selection workflow clearer for first-time users.

Changes:

  • Added a brief "Pull vs build" guidance block to docs/using/selecting.md

@mathbunnyru mathbunnyru merged commit 76b23b6 into jupyter:main Jan 27, 2026
4 checks passed
@CoderLink06
Copy link
Contributor Author

I added a small follow-up clarification to docs/using/running.md explaining host vs container port mapping for the -p 10000:8888 example, since this seems to be a common source of confusion for new users.

Happy to adjust or remove if you’d prefer this to live elsewhere in the docs.

@mathbunnyru
Copy link
Member

I added a small follow-up clarification to docs/using/running.md explaining host vs container port mapping for the -p 10000:8888 example, since this seems to be a common source of confusion for new users.

Happy to adjust or remove if you’d prefer this to live elsewhere in the docs.

I think it's already explained quite well, and I haven't seen any questions about it.
Let's keep docs like this for now, because providing too much information is also not the best thing.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants