OBSDOCS-3567: Remove duplicate and obsolete Loki sizing section

[johnwilkins]

Summary

Removes duplicate and obsolete Loki deployment sizing content from the Loki Operator installation guide and replaces it with a link to the comprehensive Chapter 4 sizing guide.

Problem

Duplicate content:

• Section 5.1 "Loki deployment sizing" in the Loki Operator installation guide
• Chapter 4 "Loki deployment sizing" (comprehensive guide)

Obsolete information:

• The embedded module (modules/loki-deployment-sizing.adoc) was missing the 1x.pico t-shirt size
• Table did not reflect current sizing options
• Created confusion with two conflicting sources of sizing information

Solution

✅ Removed include::modules/loki-deployment-sizing.adoc[leveloffset=+1]
✅ Added NOTE block directing users to the comprehensive sizing chapter
✅ Single source of truth for Loki sizing guidance

Changes

Modified:

• installing/installing-the-loki-operator.adoc: Replaced sizing module include with NOTE containing xref to Chapter 4

Before:
Users saw an incomplete sizing table embedded in the installation procedure.

After:
Users are directed to review the comprehensive sizing guide before installation, which includes:

• All current t-shirt sizes (1x.pico, 1x.demo, 1x.extra-small, 1x.small, 1x.medium)
• Per-component resource breakdowns
• Sizing interpretation guidance
• Current recommendations

Note on DITA Warnings

Vale shows 6 DITA warnings about the xref being in a NOTE instead of Additional resources. This is acceptable because:

• The link serves as prerequisite guidance before installation
• Inline placement improves user experience (users see it before starting installation)
• This pattern is common for prerequisite/planning information

Testing

• ✅ Vale: 0 errors, 6 DITA warnings (acceptable - see above)
• ✅ Xref target verified (loki-deployment-sizing.adoc exists)
• ✅ NOTE placement tested for user flow

Related

• JIRA: https://redhat.atlassian.net/browse/OBSDOCS-3567
• Preview: https://114576--ocpdocs-pr.netlify.app/openshift-logging/latest/installing/installing-the-loki-operator.html
• Versions: 6.6, 6.5, 6.4

Signed-off-by: John Wilkins jowilkin@redhat.com

🤖 Generated with Claude Code

[openshift-ci-robot]

@johnwilkins: This pull request references OBSDOCS-3567 which is a valid jira issue.

Details

In response to this:

Summary

Removes duplicate and obsolete Loki deployment sizing content from the Loki Operator installation guide and replaces it with a link to the comprehensive Chapter 4 sizing guide.

Problem

Duplicate content:

• Section 5.1 "Loki deployment sizing" in the Loki Operator installation guide
• Chapter 4 "Loki deployment sizing" (comprehensive guide)

Obsolete information:

• The embedded module (modules/loki-deployment-sizing.adoc) was missing the 1x.pico t-shirt size
• Table did not reflect current sizing options
• Created confusion with two conflicting sources of sizing information

Solution

✅ Removed include::modules/loki-deployment-sizing.adoc[leveloffset=+1]
✅ Added NOTE block directing users to the comprehensive sizing chapter
✅ Single source of truth for Loki sizing guidance

Changes

Modified:

• installing/installing-the-loki-operator.adoc: Replaced sizing module include with NOTE containing xref to Chapter 4

Before:
Users saw an incomplete sizing table embedded in the installation procedure.

After:
Users are directed to review the comprehensive sizing guide before installation, which includes:

• All current t-shirt sizes (1x.pico, 1x.demo, 1x.extra-small, 1x.small, 1x.medium)
• Per-component resource breakdowns
• Sizing interpretation guidance
• Current recommendations

Note on DITA Warnings

Vale shows 6 DITA warnings about the xref being in a NOTE instead of Additional resources. This is acceptable because:

• The link serves as prerequisite guidance before installation
• Inline placement improves user experience (users see it before starting installation)
• This pattern is common for prerequisite/planning information

Testing

• ✅ Vale: 0 errors, 6 DITA warnings (acceptable - see above)
• ✅ Xref target verified (loki-deployment-sizing.adoc exists)
• ✅ NOTE placement tested for user flow

Related

• JIRA: https://redhat.atlassian.net/browse/OBSDOCS-3567

Signed-off-by: John Wilkins jowilkin@redhat.com

🤖 Generated with Claude Code

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 openshift-eng/jira-lifecycle-plugin repository.

[ocpdocs-previewbot]

🤖 Thu Jul 02 18:58:43 - Prow CI generated the docs preview:

https://114576--ocpdocs-pr.netlify.app/
https://114576--ocpdocs-pr.netlify.app/openshift-logging/latest/installing/installing-the-loki-operator.html

[openshift-ci]

@johnwilkins: all tests passed!

Full PR test history. Your PR dashboard.

Details

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.

[johnwilkins]

@briandooley Can we cherry pick those to 6.6, 6.5, and 6.4. My apologies. I forgot to add that to the PR. Now that the IA is relatively stable, the auto cherry picking seems to work better now. Let me know if it doesn't work, and I'll send some manual cherry picks your way.