We got the following feedback for section 3.1 Retrieving topology-specific service configuration in the 18.0 adoption guide:

• Section 3.1, prerequisite 2, it has this:
      $ CONTROLLER1_SSH="ssh -i <path to SSH key> root@<node IP>"
  There is no mention about adding passwordless SSH from the OCP provisioning node to the RHOSP17.1 overcloud nodes.
• Section 3.1 - it looks like steps 1-5 are just showing pieces of the overall script provided in step 6? They do use different mariadb client commands/scripts, but I don't see what they're doing differently, as they are (re-)setting the same environment variables.

• Section 3.1, step 2, the run_mysqlcheck function should use $1 instead of $CELL for the statement:
      ... SOURCE_MARIADB_IP[$CELL] ... SOURCE_DB_ROOT_PASSWORD[$CELL]
• Section 3.1, step 6 creates a shell script that runs openshift control plane commands, and ssh's into the RHOSP17.1 overcloud nodes. There is no mention of needing the public key for passwordless ssh to the RHOSP17.1 overcloud nodes from the RHOSO 18 provisioning node (although this comment is the same as above)