Skip to content

[RHIDP-14698][RHIDP-14699][RHIDP-14700][RHIDP-14701]: Populate Reference category MAP files with module includes#2396

Merged
themr0c merged 2 commits into
redhat-developer:mainfrom
themr0c:RHIDP-14697-reference-category-map-population
Jun 19, 2026
Merged

[RHIDP-14698][RHIDP-14699][RHIDP-14700][RHIDP-14701]: Populate Reference category MAP files with module includes#2396
themr0c merged 2 commits into
redhat-developer:mainfrom
themr0c:RHIDP-14697-reference-category-map-population

Conversation

@themr0c

@themr0c themr0c commented Jun 19, 2026

Copy link
Copy Markdown
Member

Caution

IMPORTANT: Do Not Merge
This PR requires review and approval before merging.

Version(s)

N/A (JTBD migration — structural change only)

Issue

Preview

N/A

Summary

Populates the Reference category MAP files with actual include:: directives, replacing all TODO placeholders for the 4 L2 jobs:

  • Dynamic plugin parameter reference (RHIDP-14698): 5 module includes from extend_dynamic-plugins-reference/
  • Permission policies and conditional rules (RHIDP-14699): concept file populated (nav files were already done)
  • Trace attributes and OpenTelemetry (RHIDP-14700): collapsed OpenTelemetry configurations (1 module) into parent nav, populated trace attributes sub-nav with 4 modules
  • Helm chart configuration parameters (RHIDP-14701): 8 module includes from configure_helm-chart-config-reference/

Additional fixes

  • Fixed artifact include paths in 6 module files: ../../artifacts/{docdir}/artifacts/ to resolve correctly when included through the MAP file symlink chain. Also fixed .template.adoc files to prevent auto-generation from reverting the fix.

Files changed (20)

  • 12 nav/con files populated in category-maps/reference/
  • 2 nav/con files deleted (collapse rule for OpenTelemetry configurations)
  • 6 module files fixed for {docdir} artifact paths

Co-Authored-By: Claude Opus 4.6 noreply@anthropic.com

…nce category MAP files with module includes

Replace TODO placeholders with actual include directives for all 4
Reference category L2 jobs: dynamic plugin parameters, permission
policies, trace attributes/OpenTelemetry, and Helm chart parameters.

- Populate nav files with module includes and navtitle overrides
- Populate concept files with content from old assemblies
- Collapse OpenTelemetry configurations (1 module) into parent nav
- Fix artifact include paths: ../../artifacts/ -> {docdir}/artifacts/
  in 6 module files (including .template.adoc for auto-generation)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@rhdh-bot

rhdh-bot commented Jun 19, 2026

Copy link
Copy Markdown
Collaborator

PR Build Results

Build passed -- 36/36 titles | 128s
Preview: https://redhat-developer.github.io/red-hat-developers-documentation-rhdh/pr-2396/


Content Quality Assessment

CQA Report

  • CQA-00a: Orphaned modules
  • CQA-00b: Directory structure
  • CQA-01: Vale AsciiDoc DITA compliance
  • CQA-02: Verify assembly structure
  • CQA-03: Verify content type metadata
  • CQA-04: Verify module templates
  • CQA-05: Verify required modular elements
  • CQA-06: Verify assemblies follow official template (one user story)
  • CQA-07: Verify TOC depth (max 3 levels)
  • CQA-08: Verify short description content quality
  • CQA-09: Verify short description format
  • CQA-10: Verify titles are brief, complete, and descriptive
  • CQA-11: Verify procedure prerequisites
  • CQA-12: Verify grammar and style (Vale)
  • CQA-13: Verify content matches declared type
  • CQA-14: Verify no broken links
  • CQA-14b: Inbound link stability (no ID changes for existing files)
  • CQA-15: Check redirects
  • CQA-16: Verify official product names
  • CQA-17: Verify legal disclaimers for preview features
  • CQA-jtbd-01: Verify navigation file structure

Summary

Checks: 21 total, 21 pass, 0 fail

21 checks: 21 pass, 0 fail

Run node build/scripts/cqa/index.js --all --fix locally to review and auto-fix issues.


Updated 2026-06-19 14:20:42 UTC

…ions

The nav file's navtitle and concept file's tier listing are categorical
labels, not feature declarations — the actual disclaimer lives in the
included module.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@themr0c themr0c merged commit f52a192 into redhat-developer:main Jun 19, 2026
6 checks passed
@themr0c themr0c deleted the RHIDP-14697-reference-category-map-population branch June 19, 2026 14:23
@sonarqubecloud

Copy link
Copy Markdown

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants