Bug 1311098

Summary: Address feedback on Chapter 1
Product: Red Hat Satellite Reporter: Andrew Dahms <adahms>
Component: Docs Install GuideAssignee: Allison Heslin <aheslin>
Status: CLOSED CURRENTRELEASE QA Contact: Brandi Munilla <bmcelvee>
Severity: medium Docs Contact:
Priority: medium    
Version: Unspecified   
Target Milestone: Unspecified   
Target Release: Unused   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2016-04-27 23:58:04 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:

Description Andrew Dahms 2016-02-23 11:52:26 UTC
The following items must be addressed in Chapter 1. of the Installation Guide:

* Change the title to 'Introduction to Installing Red Hat Satellite'

* Make section 1.2 and 1.3 appendix items that are linked to from Chapter 1.

* s/Host systems can pull content from the Capsule Server and not from the 
  central Satellite Server./Host systems can pull content from the Capsule 
  Server instead of the central Satellite Server./

* "Although different variations and combinations exist..." - Can a little 
  more detail be added, such as "Although Red Hat Satellite Server can be 
  configured in a number of configurations and in combination with Red Hat 
  Satellite Capsule Server"?

Comment 1 Andrew Dahms 2016-02-23 11:59:45 UTC
Assigning to Ali for review.

Comment 2 Allison Heslin 2016-02-23 14:08:52 UTC
* I don't think the proposed title change to Introduction to Installing is necessary, although I agree that there is some rework to do. I would like to wait on this to see if section 1.1 should end up in the Architecture Guide.

* I actually agree with Russell that creating a scalability section might be worthwhile, but this needs more discussion.

* Change made.

* Change made with slight variation.

** So because of the first two comments, chapter one could very easily become very short and just describe what Satellite and Capsule Servers do.

Comment 3 Allison Heslin 2016-03-07 14:00:02 UTC
Per email conversation with Rich, removing the Common Deployment Scenarios section since it will be covered in the Architecture Guide. I also moved the Large Deployment Scenarios and Capsule Server Scalability Considerations to an Appendix. Both are linked from the Preparing for installation overview section.

Comment 4 Andrew Dahms 2016-04-27 23:58:04 UTC
This content is now live on the Customer Portal.

Closing.