-
Story
-
Resolution: Unresolved
-
Normal
-
None
-
None
Move Converting a host to RHEL (Managing hosts) to a standalone guide called "Converting hosts to RHEL".
Use case: Converting many Oracle/CentOS Linux hosts to RHEL by using Satellite.
Reasons for creating a separate book:
- Converting multiple hosts to RHEL is not a routine task. It requires months of planning and is expensive.
- Title should be plural to reflect the use case (RHEL guide procedures are for small numbers of hosts; Satellite is for large-scale conversion)
- Prerequisites are complex. It would be better to break them into actual procedures.
- Several steps in the current procedure (import Ansible role and variables, assign role to hosts) are actually separate procedures. This forces a user to jump between guides to perform a complex task, which is not a good user experience.
Task scope:
- Planning section:
- Separate prerequisites from planning. Planning includes tasks like reading documentation.
- Prerequisites:
- Try to avoid links. If they are procedures, re-use the existing procedure module.
- True prerequisites are items that must be done in order for the conversion to succeed (installing convert2rhel, for example).
- Procedure:
- Begin with a high-level procedure or description.
- Turn steps into procedures, where appropriate, reusing modules instead of linking to other docs.