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.
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.