Bug 1385428 - Software requirements stated in two places are contradictory
Summary: Software requirements stated in two places are contradictory
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Satellite
Classification: Red Hat
Component: Docs Virtual Instances Guide
Version: 6.2.0
Hardware: Unspecified
OS: Unspecified
medium
medium vote
Target Milestone: Unspecified
Assignee: Russell Dickenson
QA Contact: Brandi Munilla
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2016-10-17 01:49 UTC by Russell Dickenson
Modified: 2019-09-25 20:38 UTC (History)
2 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2016-10-19 02:58:49 UTC
Target Upstream Version:


Attachments (Terms of Use)

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/


Note You need to log in before you can comment on or make changes to this bug.