Bug 1188133

Summary: [RFE] Add best practices, workflow-like documentation
Product: Red Hat Satellite Reporter: Fred van Zwieten <fvzwieten>
Component: DocumentationAssignee: Athene Chan <achan>
Status: CLOSED NOTABUG QA Contact: David O'Brien <daobrien>
Severity: high Docs Contact:
Priority: medium    
Version: 6.0.7CC: bkearney, dlackey, mmurray, xdmoon
Target Milestone: UnspecifiedKeywords: FutureFeature
Target Release: Unused   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Enhancement
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2015-02-06 06:20:14 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 Fred van Zwieten 2015-02-02 07:01:03 UTC
Description of problem:
What I miss in the documentation is more sections on how to best use the different components together. I experience users (sys admins) often get lost because of the sheer amount of concepts that are brought together in this product. What are the best practices. Describe sample use cases (For example: DEV-QA-PROD). Write out how all different aspect interlock and work together. When to best use compiste content views? When not? How to model your host groups, host collections, etc, in combination with you activation keys, conent views, life cycle envrionment? I see a lot of mistakes happen when using Satellite 6 for the first time. Some call this "best practices", other call this "work flows" and some call is "patterns". You could even think about setting it up as a "cook book". Describe, for example, an imaginary IT shop, with a typical DEV-QA-PROD staging setup or some variation on that, and multiple business apps that need to be managed. Add a mixtures of external third party yum repo's and internal dev shops, some of who deliver RPM's and Puppet modules, some don't. Then describe how to set this all up in Satellite. 

Version-Release number of selected component (if applicable):


How reproducible:
Give a sysadmin Satellite (without any prior knowledge of the product), let him first read the docs, and then let him use it. Observe what happens.

Steps to Reproduce:
1.
2.
3.

Actual results:
Much trail and error happening 

Expected results:
Get it set up correctly in one go

Additional info:


Document URL: 

Section Number and Name: 

Describe the issue: 

Suggestions for improvement: 

Additional information:

Comment 2 RHEL Program Management 2015-02-02 07:13:39 UTC
Since this issue was entered in Red Hat Bugzilla, the release flag has been
set to ? to ensure that it is properly evaluated for this release.