Skip to content

OSDOCS-14552 greatly reducing Azure sample install config files #92943

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

bscott-rh
Copy link
Contributor

@bscott-rh bscott-rh commented May 2, 2025

Version(s):
4.19

Issue:
https://issues.redhat.com/browse/OSDOCS-14552

Link to docs preview:
Customizations

QE review:

  • QE has approved this change.

Problem statement:
The sample install-config.yaml file (aws for example) is:

  1. heavily conditionalized due to mod-docs attempt to use one module to cover many assemblies
  2. impossible for writers to maintain due to the complicated conditional structures and annotations
  3. inconsistent with regards to which parameters have dedicated callouts to explain them
  4. perpetually out of date with engineering's recommendations due to the complexity and effort required to update it
  5. different from platform to platform, leading to confusing and inconsistent customer experience

Proposal:
Remove the existing sample file and replace it with a boilerplate minimum viable install-config.yaml file. Use the same file for all assemblies in a platform (or with the minimum possible variation between them, for example an extra parameter for the disconnected installation method) and ideally the same basic file for all platforms where possible. Remove all of the existing annotations/callouts and replace them with a short set of annotations that describe the structure and syntax of the file, rather than each individual parameter. Clearly indicate that this file is a minimum viable sample, and that all customizations should be made based on the Installation Configuration Parameters table, where all parameters are listed and described in great detail.

@bscott-rh bscott-rh added this to the Planned for 4.19 GA milestone May 2, 2025
@openshift-ci openshift-ci bot added the size/M Denotes a PR that changes 30-99 lines, ignoring generated files. label May 2, 2025
@@ -0,0 +1,55 @@
// Module included in the following assemblies:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] OpenShiftAsciiDoc.ModuleContainsContentType: Module is missing the '_mod-docs-content-type' variable.

Copy link

openshift-ci bot commented May 2, 2025

@bscott-rh: all tests passed!

Full PR test history. Your PR dashboard.

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-sigs/prow repository. I understand the commands that are listed here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
branch/enterprise-4.19 size/M Denotes a PR that changes 30-99 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants