Bug 1416238

Summary:	[Docs][Ironic] Implement peer review feedback for the Bare Metal Provisioning guide
Product:	Red Hat OpenStack	Reporter:	Lucy Bopf <lbopf>
Component:	documentation	Assignee:	RHOS Documentation Team <rhos-docs>
Status:	CLOSED WONTFIX	QA Contact:	RHOS Documentation Team <rhos-docs>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	8.0 (Liberty)	CC:	mburns, srevivo
Target Milestone:	---
Target Release:	---
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:	2018-03-26 01:35:24 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 Lucy Bopf 2017-01-25 02:06:08 UTC

The following suggestions were provided by Sandra McCann during peer review of the RHOSP 8 Bare Metal Provisioning guide:

1. The section titles in the Troubleshooting section are quite long, and the resulting links may be truncated by search engines in a way that removes critical information. The titles must be reviewed for clarity and brevity, and to ensure that the key point of the title is immediately clear.

2. A lack of consistency of sample commands can be confusing as you move between chapters. The document must be reviewed to make the consistency between sample commands clearer (so a user can tell which IP address is the internal IP vs VIP vs Bare Metal Node IP, for example).

3. As an extension of 2., a topology with labels that are used throughout the sample commands would be useful. The feasibility of such an approach should be investigated.

Comment 1 Lucy Bopf 2018-03-26 01:35:24 UTC

The Bare Metal Provisioning Guide underwent a restructure with technology changes in RHOSP 10, and much of this feedback either no longer applies or should be captured as part of larger review efforts. Given the team's current commitments for RHOSP 13 and other more recent versions, I'm closing this one as WONTFIX.