I suggest a few changes to Chapter 1 in the FFU guide to help clarify some places where customers continue to get stuck, confused or need clearer guidance.

1. We should ask the reader to review  https://docs.redhat.com/en/documentation/red_hat_openstack_platform/17.1/html-single/overcloud_parameters/index and https://docs.redhat.com/en/documentation/red_hat_openstack_platform/17.1/html-single/configuration_reference/index to identify any parameters which are being used in their templates which are marked as deprecated, or are no longer present in that documentation. These parameters would need to be adjusted with the updated templates used during the upgrade.
2. The content from https://docs.redhat.com/en/documentation/red_hat_openstack_services_on_openshift/18.0/html/adopting_a_red_hat_openstack_platform_director_operator_environment/rhoso-180-adoption-overview_assembly#adoption-guidelines_planning should be ported back with some adjustments to be more relevant to RHOSP.