Secondary NIC support for OSP IPI - OSDOCS-1033

[maxwelldb]

Context: https://issues.redhat.com/browse/OSDOCS-1033

[openshift-docs-preview-bot]

The preview will be available shortly at:

• https://osp-secondary-nic-osdocs1033--ocpdocs.netlify.com/

[maxwelldb]

At the moment, this PR just includes relevant params. Unsure about additional work required at this point.

[maxwelldb]

@wjiangjay Would you be able to review this PR?

[maxwelldb]

QE ack in Jira w/CSS comment to address (c115197)

[maxwelldb]

@kalexand-rh Would you be able to look at this given that your tables are magnificent? 🥇

[kalexand-rh]

One pick, one gripe. I hope you can file a bug for that wrapping problem.

[maxwelldb]

@vikram-redhat Would you be able to take a look at this? Kathryn and I do not understand how we can use identical column options for the "Required parameters" and "Optional {rh-openstack} parameters" tables with different results. :(

[maxwelldb]

@adellape No rush at all, but Vikram mentioned that you might have an idea about this problem.

This row:

This row:

And this row:

Look quite different. :(

All have the same col options:
cols=".^2,.^3,.^5a"

Their content is similar, too, but text wrapping is only borked in the final example.

Any thoughts about what's going on?

Cursed preview tables: https://osp-secondary-nic-osdocs1033--ocpdocs.netlify.app/openshift-enterprise/latest/installing/installing_openstack/installing-openstack-user-kuryr.html#installation-configuration-parameters_installing-openstack-user-kuryr

[adellape]

@maxwelldb It looks like since the verbatim marked-up names in the "Parameter" column are being considered single words that can't wrap, that first column becomes as wide at the longest entry, squishing the other columns. In that final example's case, it's controlPlane.platform.openstack.additionalSecurityGroupIDs. In your first example, however, there is a <platform>, and it looks like for some reason it does wrap when it hits a <. When I threw some <> around the long ones in the final example's table, it wrapped them and narrowed the columns.

[maxwelldb]

@adellape 🙇‍♂️ https://giphy.com/gifs/cat-dead-NjevnbNiUmeLm

[maxwelldb]

/cherry-pick enterprise-4.5

[openshift-cherrypick-robot]

@maxwelldb: #22174 failed to apply on top of branch "enterprise-4.5":

Applying: Move optional params into separate table
Using index info to reconstruct a base tree...
M	modules/installation-configuration-parameters.adoc
Falling back to patching base and 3-way merge...
Auto-merging modules/installation-configuration-parameters.adoc
Applying: Cleaning up linebreaks
error: Failed to merge in the changes.
Using index info to reconstruct a base tree...
M	modules/installation-configuration-parameters.adoc
Falling back to patching base and 3-way merge...
Auto-merging modules/installation-configuration-parameters.adoc
CONFLICT (content): Merge conflict in modules/installation-configuration-parameters.adoc
Patch failed at 0003 Cleaning up linebreaks

Details

In response to this:

/cherry-pick enterprise-4.5

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.