RHIDP-4929 /RHIDP-4930 Moving content to Configuring and Customizing titles

[themr0c]

• Created these new titles to populate the Configure category, and populated them with content from the Admin guide and the Getting started guide:

  • Configuring: https://redhat-developer.github.io/red-hat-developers-documentation-rhdh/pr-721/configuring/

  • Customizing: https://redhat-developer.github.io/red-hat-developers-documentation-rhdh/pr-721/customizing/

• Moved remaining sections from the Getting started guide to https://redhat-developer.github.io/red-hat-developers-documentation-rhdh/pr-721/plugins-rhdh-configure/

• Removed empty titles: Admin guide, Getting started guide.

Work on consistency: rewritten some titles and metadata, renamed some files, added missing symbolic links.

Rewritten "Provisioning your custom configuration" to be technically accurate, and promoting clearly the idea that the user should provision and register configuration files before deploying.

IMPORTANT: Do Not Merge - To be merged by Docs Team Only

Version(s): 1.3.x, 1.4

Add the relevant labels to the Pull Request.
Issue: https://issues.redhat.com/browse/RHIDP-4929 https://issues.redhat.com/browse/RHIDP-4930

Note that, the scope of this pull request being already too big, some things are left rough:

• We miss a complete reference for the app-config.yaml file fields.
• We need new procedures explaining how to do the first deployment with the correct configuration, rather than reconfiguring a previously deployed rhdh instance.
• The existing procedures should be reworked to make clear it is about reconfiguring a rhdh instance not using the config maps.
• Configuring the proxy by using the operator is a specific used case of configuring the deployment by using the operator.
• Leftovers in Getting Started require attention.

[rhdh-bot]

Updated preview: https://redhat-developer.github.io/red-hat-developers-documentation-rhdh/pr-721/ @ 12/16/24 09:32:27

[themr0c]

@kadel @gazarenkov Can you give your formal approval?

[themr0c]

/cherry-pick release-1.4

[openshift-cherrypick-robot]

@themr0c: once the present PR merges, I will cherry-pick it on top of release-1.4 in a new PR and assign it to you.

In response to this:

/cherry-pick release-1.4

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.

[openshift-cherrypick-robot]

@themr0c: #721 failed to apply on top of branch "release-1.4":

Applying: RHIDP-4929 Moving content to dedicated titles for the Configure category
Applying: Update titles/configuring/master.adoc
Applying: moving procedures on @kadel suggestion
Applying: fix build
Applying: reformulate for clarity
Applying: reformulate for clarity
Applying: Added app.branding
Applying: Update assemblies/assembly-configuring-techdocs.adoc
Applying: Update assemblies/assembly-customizing-the-appearance.adoc
Applying: Update modules/configuring/proc-provisioning-your-custom-configuration.adoc
Applying: Update modules/configuring/proc-registering-your-custom-configuration-by-using-the-operator.adoc
Applying: Update modules/configuring/proc-registering-your-custom-configuration-by-using-the-operator.adoc
Applying: Update modules/configuring/proc-adding-custom-configuration-files-by-using-the-operator.adoc
Applying: docs: implemented suggestions
Applying: Apply suggestions from code review
Applying: Update modules/configuring-deployment/proc-configuring-deployment-by-using-the-operator.adoc
Applying: Update modules/configuring/proc-provisioning-your-custom-configuration.adoc
Applying: added product-custom-resource-type attribute
Using index info to reconstruct a base tree...
M	artifacts/attributes.adoc
Falling back to patching base and 3-way merge...
Auto-merging artifacts/attributes.adoc
CONFLICT (content): Merge conflict in artifacts/attributes.adoc
error: Failed to merge in the changes.
hint: Use 'git am --show-current-patch=diff' to see the failed patch
hint: When you have resolved this problem, run "git am --continue".
hint: If you prefer to skip this patch, run "git am --skip" instead.
hint: To restore the original branch and stop patching, run "git am --abort".
hint: Disable this message with "git config advice.mergeConflict false"
Patch failed at 0018 added product-custom-resource-type attribute

In response to this:

/cherry-pick release-1.4

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.

[rm3l]

@themr0c Curious why this was removed? Is this intentional? This was added in #709 to clarify how the NO_PROXY env var is handled in RHDH, as a follow-up to a few customer issues.

[themr0c]

My mistake. Lost in rebase. Restoring it: #811