Update README.md by rotata · Pull Request #1 · microsoft/containerregistry · GitHub
Skip to content

Update README.md - #1

Merged
Rohit Tatachar (rotata) merged 4 commits into
masterfrom
rotata-patch-1
May 23, 2019
Merged

Rohit Tatachar (rotata) merged 4 commits into
masterfrom
rotata-patch-1

Conversation

@rotata

Copy link
Copy Markdown

Adding FAQ

Comment thread README.md Outdated

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I'm not crazy about the formatting as it isn't easy to quickly scan and pick out the questions.. I would suggest using bullets for each question. Consider making the question bold and use a '?' for each question.

  • How does MCR work with Dockerhub?
    MCR is a public registry that houses Microsoft First party images but it does not have its own catalog UI experience. Docker Hub is the official source for our customers to discover official Microsoft-published container images. For further details of this integration please visit our blog

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

agreed, will incorporate those changes

Comment thread README.md Outdated

# Contributing
# FAQ
How does MCR work with Dockerhub - MCR is a public registry that houses Microsoft First party images but it does not have its own catalog UI experience. Docker Hub is the official source for our customers to discover official Microsoft-published container images. For further details of this integration please visit our [blog](https://cloudblogs.microsoft.com/opensource/2019/01/17/improved-discovery-experience-microsoft-containers-docker-hub/)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
How does MCR work with Dockerhub - MCR is a public registry that houses Microsoft First party images but it does not have its own catalog UI experience. Docker Hub is the official source for our customers to discover official Microsoft-published container images. For further details of this integration please visit our [blog](https://cloudblogs.microsoft.com/opensource/2019/01/17/improved-discovery-experience-microsoft-containers-docker-hub/)
How does MCR work with Dockerhub - MCR is a public registry that houses Microsoft first party images but it does not have its own catalog UI experience. Docker Hub is the official source for our customers to discover official Microsoft-published container images. For further details of this integration please visit our [blog](https://cloudblogs.microsoft.com/opensource/2019/01/17/improved-discovery-experience-microsoft-containers-docker-hub/).

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Just to add: "first-party" is kind of internal jargon. "Microsoft-published" as you state in the second sentence is better.

Comment thread README.md Outdated
# FAQ
How does MCR work with Dockerhub - MCR is a public registry that houses Microsoft First party images but it does not have its own catalog UI experience. Docker Hub is the official source for our customers to discover official Microsoft-published container images. For further details of this integration please visit our [blog](https://cloudblogs.microsoft.com/opensource/2019/01/17/improved-discovery-experience-microsoft-containers-docker-hub/)

What is the difference between MCR and ACR - MCR is a public registry for housing only Mcirosoft's official Container images. ACR is a private container Registry for housing Our customers container Images.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
What is the difference between MCR and ACR - MCR is a public registry for housing only Mcirosoft's official Container images. ACR is a private container Registry for housing Our customers container Images.
What is the difference between MCR and ACR - MCR is a public registry for housing only Microsoft's official container images. ACR is a private container registry for housing our customers' container images.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Also suggest spelling out "Azure Container Registry (ACR)" on first use.

Comment thread README.md Outdated

What is the difference between MCR and ACR - MCR is a public registry for housing only Mcirosoft's official Container images. ACR is a private container Registry for housing Our customers container Images.

Can I browse MCR - Since MCR does not have a UI/discovery experience, the only experince with the registry is for interacting with a container image. Ex: docker pull mcr.microsoft.com/windows/servercore:ltsc2019

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
Can I browse MCR - Since MCR does not have a UI/discovery experience, the only experince with the registry is for interacting with a container image. Ex: docker pull mcr.microsoft.com/windows/servercore:ltsc2019
Can I browse MCR - No, MCR does not have a UI/discovery experience. Docker Hub is where you go to browse the official Microsoft repositories.

@dlepow Dan Lepow (dlepow) left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Agree with Michael's comments, and added a couple suggestions. I'm not entirely clear on the intended audience for this, but it might (?) be helpful to add a question/answer like "How do I onboard my image to MCR" with answer like "See https://aka.ms/mcr/onboarding (Microsoft internal only)."

Comment thread README.md
@@ -3,8 +3,14 @@ MCR is the primary Registry for all first party Microsoft docker images that off

Since MCR has no UI of its own, this Github is a means to take customer inputs and feedback. Please use this repo to provide your feedback on usage or concerns with MCR.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Suggest spelling out "Microsoft Container Registry (MCR)" on first use.

Comment thread README.md Outdated

# Contributing
# FAQ
How does MCR work with Dockerhub - MCR is a public registry that houses Microsoft First party images but it does not have its own catalog UI experience. Docker Hub is the official source for our customers to discover official Microsoft-published container images. For further details of this integration please visit our [blog](https://cloudblogs.microsoft.com/opensource/2019/01/17/improved-discovery-experience-microsoft-containers-docker-hub/)

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Just to add: "first-party" is kind of internal jargon. "Microsoft-published" as you state in the second sentence is better.

Comment thread README.md Outdated

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Also suggest spelling out "Azure Container Registry (ACR)" on first use.

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.

4 participants