Skip to content

docs(gitlab): split integration config from auth in GitLab docs#2378

Open
evanshortiss wants to merge 4 commits into
redhat-developer:mainfrom
evanshortiss:gitlab-integration-docs
Open

docs(gitlab): split integration config from auth in GitLab docs#2378
evanshortiss wants to merge 4 commits into
redhat-developer:mainfrom
evanshortiss:gitlab-integration-docs

Conversation

@evanshortiss

Copy link
Copy Markdown
Contributor

The GitLab integration setup (PAT + integrations.gitlab) was bundled into "Share secrets with GitLab" under the Authentication title, forcing customers who only need the integration (e.g. using Keycloak for auth) to navigate auth docs for non-auth setup.

This adds a standalone "Configure the GitLab integration" procedure to the Integration title and narrows "Share secrets with GitLab" to OAuth-only content.

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

Version(s):
RHDH 1.9
Issue:
N/A
Preview:

The GitLab integration setup (PAT + integrations.gitlab) was bundled
into "Share secrets with GitLab" under the Authentication title,
forcing customers who only need the integration (e.g. using Keycloak
for auth) to navigate auth docs for non-auth setup.

This adds a standalone "Configure the GitLab integration" procedure
to the Integration title and narrows "Share secrets with GitLab" to
OAuth-only content.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@rhdh-bot

rhdh-bot commented Jun 25, 2026

Copy link
Copy Markdown
Collaborator

PR Build Results

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


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
  • CQA-jtbd-02: Modules not yet in product_product (informational)

Summary

Checks: 22 total, 22 pass, 0 fail

Modules not yet in product_product

1 modules (proc, con, ref) are not yet included in the product_product title.

modules/shared/ (1)
  • modules/shared/proc-configure-the-gitlab-integration.adoc

22 checks: 22 pass, 0 fail

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


Updated 2026-06-26 08:40:40 UTC

@themr0c themr0c deployed to external June 26, 2026 08:36 — with GitHub Actions Active
@sonarqubecloud

Copy link
Copy Markdown

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants