Bug 1260486

Summary: More description on how to create objects and consistency through topics
Product: OpenShift Container Platform Reporter: brice <bfallonf>
Component: DocumentationAssignee: brice <bfallonf>
Status: CLOSED DUPLICATE QA Contact: Vikram Goyal <vigoyal>
Severity: low Docs Contact: Vikram Goyal <vigoyal>
Priority: low    
Version: 3.0.0CC: aos-bugs, jokerman, mmccomas
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard: 3.7-release-plan
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2017-09-19 06:13:15 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description brice 2015-09-07 05:14:33 UTC 
The "Integrating External Services" topic assumes you know how to create a service:

https://docs.openshift.com/enterprise/3.0/dev_guide/integrating_external_services.html#creating-the-service

The example of how to create an object and upload it to your OS instance is outlined in the "Templates" topic:

https://docs.openshift.com/enterprise/3.0/dev_guide/templates.html#creating-resources-from-a-template

I suggest:

-- Making the process outlined in a central location that isn't specific to an object. Maybe in the architecture section.
-- In each topic where the reader is expected to create an object, link back to that process.
-- Each topic (pretty much) would have to be checked.

I have heard that this process will disappear soon though, but at the moment, it's not intuitive enough for new readers.
Comment 2 Vikram Goyal 2017-09-19 06:13:15 UTC 

*** This bug has been marked as a duplicate of bug 1258291 ***