Bug 1328573

Summary:	Image Registry help does not describe how to use it
Product:	OKD	Reporter:	Jonathan Yu <jawnsy>
Component:	Documentation	Assignee:	Nobody <nobody>
Status:	NEW ---	QA Contact:	Ronaldo Rivera <rrivera>
Severity:	medium	Docs Contact:
Priority:	unspecified
Version:	3.x	CC:	aos-bugs, mmccomas
Target Milestone:	---
Target Release:	---
Hardware:	All
OS:	All
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:		Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:

Description Jonathan Yu 2016-04-19 17:56:54 UTC

Document URL: https://docs.openshift.org/latest/architecture/infrastructure_components/image_registry.html#integrated-openshift-registry

Section Number and Name: Section 2, Integrated OpenShift Registry

Describe the issue: The document describes what the registry is, but does not cross-link to the page that describes how to actually use it.

Suggestions for improvement: I think it would be helpful to have it link to this page, which has instructions describing how to push images to the internal registry: https://docs.openshift.org/latest/install_config/install/docker_registry.html

Additional information: Affects latest Origin code as well as OSE

Comment 1 Jonathan Yu 2016-05-05 16:46:43 UTC

Copied from #1333504

Document URL:

https://docs.openshift.org/latest/install_config/install/docker_registry.html#access-pushing-and-pulling-images

https://docs.openshift.org/latest/using_images/docker_images/index.html

Describe the issue: 

In the Installation section, we describe how to configure an internal Docker registry (something that an operator would be interested in). However, we also go on to discuss pushing and pulling to the registry, which is intended for a potentially different audience (application developers).

The documentation that describes Docker images for developers does not reference how to push or pull (or indeed, actually use) Docker images.

Suggestions for improvement: 

Move the pushing/pulling images documentation to the "Using Images" section, since it's about using images rather than installation. A link under the "See Also"/"What's Next?" section would be useful as well.

Comment 2 Jonathan Yu 2016-05-05 16:47:29 UTC

*** Bug 1333504 has been marked as a duplicate of this bug. ***