Bug 1416998

Summary: upgrade doc, call out in bold/red step people are tripping on
Product: Red Hat CloudForms Management Engine Reporter: Dave Johnson <dajohnso>
Component: DocumentationAssignee: Dayle Parker <dayleparker>
Status: CLOSED CURRENTRELEASE QA Contact: Chris Budzilowicz <cbudzilo>
Severity: high Docs Contact:
Priority: high    
Version: 5.7.0CC: abellott, cbudzilo, dayleparker, fdewaley, hhudgeon, jhardy, jocarter, jrafanie, nlamuro, obarenbo, simaishi
Target Milestone: GAKeywords: Reopened
Target Release: cfme-future   
Hardware: All   
OS: All   
Whiteboard: upgrade:doc
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: 1414815 Environment:
Last Closed: 2017-09-20 01:02:35 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:
Bug Depends On: 1414815    
Bug Blocks:    

Comment 3 Joe Rafaniello 2017-09-13 14:13:02 UTC
I didn't see it originally but a colleague did see a unclear part using the words Ruby shell:


Before:
"Failure to log out and back into the Ruby shell results in an error reporting the Ruby gem bundle is locked. In this situation, do not run the bundle install command as instructed by the shell, as CloudForms uses yum to install gems.

After:
"Failure to log out of the old shell environment and back into a new one results in an error reporting the Ruby gem bundle is locked.

Before:
"To resolve errors from running bundle install or failing to log in and out of Ruby: log out of Ruby and log back in, then run yum reinstall cfme-gemset."

After:
"... failing to log in and out of the old shell environment: log out of the current shell and log back in, then run yum reinstall cfme-gemset"

Comment 4 Dayle Parker 2017-09-18 06:41:46 UTC
Many thanks for the review/revision, Joe! That sounds a lot better -- it's not language I use frequently :)