Bug 1385428

Summary:	Software requirements stated in two places are contradictory
Product:	Red Hat Satellite	Reporter:	Russell Dickenson <rdickens>
Component:	Docs Virtual Instances Guide	Assignee:	Russell Dickenson <rdickens>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Brandi Munilla <bmcelvee>
Severity:	medium	Docs Contact:
Priority:	medium
Version:	6.2.0	CC:	adahms, mruzicka
Target Milestone:	Unspecified
Target Release:	Unused
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2016-10-19 02:58:49 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 Russell Dickenson 2016-10-17 01:49:57 UTC

Document URL: https://access.redhat.com/documentation/en/red-hat-satellite/6.2/single/virtual-instances-guide/#software_requirements

Section Number and Name: 4.2. SOFTWARE REQUIREMENTS

Describe the issue: This section states that the virt-who daemon may be installed on the Satellite Server, an external Capsule Server, or a dedicated instance of RHEL, which is correct. However, chapter 2, item 3 states that you can choose between either the Satellite Server, or a dedicated instance of RHEL.

Suggestions for improvement:

1. Correct chapter 2, item 3, to match the requirements stated in "4.2. SOFTWARE REQUIREMENTS".
2. Correct the grammar of the opening sentence in "4.2. SOFTWARE REQUIREMENTS".

Comment 1 Andrew Dahms 2016-10-17 03:37:07 UTC

Setting release flags.

Comment 3 Russell Dickenson 2016-10-17 23:02:29 UTC

Matt replied with the following via email, which I take to be subject matter expert review, so I will progress and raise a merge request.

"Thank you, Russell. I send the updated PDF over to my customer and the changes look good to both of us.  They also said thank you for the attention on updating the docs.

Matt Ruzicka"

Comment 4 Russell Dickenson 2016-10-17 23:05:47 UTC

Attention: Brandi

As noted in comment 3, the reporter and customer have reviewed the changes I made for this BZ ticket, so I have raised a merge request. Note that while making these quite minor changes, I also made some markup corrections.


git diff view:

https://gitlab.cee.redhat.com/satellite-6-documentation/virtual-instances-guide/commit/1e4bde88bb47a03ce9f2d120242d075e9e9e37f7

Merge request:

https://gitlab.cee.redhat.com/satellite-6-documentation/virtual-instances-guide/merge_requests/7

Comment 5 Andrew Dahms 2016-10-17 23:07:11 UTC

Setting release flags.

Comment 6 Brandi Munilla 2016-10-18 17:00:45 UTC

Russell,

I accepted the Merge Request and am moving this bug to Verified.

Thanks,
Brandi

Comment 7 Russell Dickenson 2016-10-19 02:58:49 UTC

Since the changes for this BZ ticket have been reviewed and approved, I have republished the Virtual Instances Guide to the Customer Portal [1].


[1] https://access.redhat.com/documentation/en/red-hat-satellite/6.2/single/virtual-instances-guide/