Skip to content
This repository was archived by the owner on Apr 13, 2026. It is now read-only.

chore: Add summaries for section overview pages#734

Merged
morri-son merged 6 commits into
open-component-model:mainfrom
morri-son:create-summaries-for-overview-pages
Mar 5, 2026
Merged

chore: Add summaries for section overview pages#734
morri-son merged 6 commits into
open-component-model:mainfrom
morri-son:create-summaries-for-overview-pages

Conversation

@morri-son

@morri-son morri-son commented Feb 26, 2026

Copy link
Copy Markdown
Contributor

On-behalf-of: Gerald Morrison (SAP) gerald.morrison@sap.com

What this PR does / why we need it

Add content to all section overview pages, that one can reach from the central docs page: https://deploy-preview-734--open-component-model.netlify.app/dev/docs/

Adopt the CSS so that the text in the details/summary section is aligned with the other text on the page (currently it is shown larger as the rest).

Summary by CodeRabbit

  • Documentation

    • Enhanced documentation pages with improved descriptions, structured introductions, learning paths, and prerequisites across Getting Started, Concepts, How-to, Overview, and Tutorials sections.
  • Style

    • Added styling for Details/Summary elements in documentation.
  • Chores

    • Updated configuration wordlist.

On-behalf-of: Gerald Morrison (SAP) <gerald.morrison@sap.com>
Signed-off-by: Gerald Morrison (SAP) <gerald.morrison@sap.com>
@morri-son morri-son requested a review from a team as a code owner February 26, 2026 11:42
@morri-son morri-son added area/documentation Documentation related kind/chore chore, maintenance, etc. labels Feb 26, 2026
@netlify

netlify Bot commented Feb 26, 2026

Copy link
Copy Markdown

Deploy Preview for open-component-model ready!

Name Link
🔨 Latest commit 16cc582
🔍 Latest deploy log https://app.netlify.com/projects/open-component-model/deploys/69a9a81354a1e60008198f37
😎 Deploy Preview https://deploy-preview-734--open-component-model.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

On-behalf-of: Gerald Morrison (SAP) <gerald.morrison@sap.com>
Signed-off-by: Gerald Morrison (SAP) <gerald.morrison@sap.com>
On-behalf-of: Gerald Morrison (SAP) <gerald.morrison@sap.com>
Signed-off-by: Gerald Morrison (SAP) <gerald.morrison@sap.com>
On-behalf-of: Gerald Morrison (SAP) <gerald.morrison@sap.com>
Signed-off-by: Gerald Morrison (SAP) <gerald.morrison@sap.com>
@coderabbitai

coderabbitai Bot commented Mar 4, 2026

Copy link
Copy Markdown

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 4ec9ab3d-b35e-468c-ba42-1ef0c17f7210

📥 Commits

Reviewing files that changed from the base of the PR and between 9f08ec8 and 16cc582.

📒 Files selected for processing (1)
  • .github/config/wordlist.txt
✅ Files skipped from review due to trivial changes (1)
  • .github/config/wordlist.txt

📝 Walkthrough

Walkthrough

This pull request enhances documentation infrastructure by updating five documentation index pages with improved descriptions and structured learning paths, adding CSS styling for details/summary elements, and expanding a spell-check wordlist.

Changes

Cohort / File(s) Summary
Configuration & Styling
.github/config/wordlist.txt, assets/scss/common/_components.scss
Added "wsl" to wordlist for spell-checking; added CSS rule styling details/summary elements with 0.95rem font-size under .docs-content.
Documentation Index Pages
content/docs/concepts/_index.md, content/docs/getting-started/_index.md, content/docs/how-to/_index.md, content/docs/overview/_index.md, content/docs/tutorials/_index.md
Expanded all five documentation index pages with updated front matter descriptions, comprehensive introductory content blocks, structured "What Are..." sections, prerequisites, and Learning Path guidance aligned with Diataxis framework. Getting Started sidebar changed from collapsed to expanded.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~18 minutes

Poem

🐰 Five docs now bloom with clearer sight,
Their paths and purposes shining bright,
With structure, guides, and learning ways,
We hop through documentation's maze!
CSS styling and spell-checks too—
A tidy warren, tried and true!

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately describes the main change: adding summaries/content to section overview pages across the documentation.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🧹 Nitpick comments (1)
assets/scss/common/_components.scss (1)

115-117: Prefer inheriting summary typography instead of hard-coding 0.95rem.

Using inherit keeps <summary> text automatically aligned with surrounding docs text when base typography changes.

Proposed tweak
 .docs-content details summary {
-  font-size: 0.95rem;  /* Kleinerer Text als normaler Absatz */
+  font-size: inherit;
+  line-height: inherit;
 }
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@assets/scss/common/_components.scss` around lines 115 - 117, The summary rule
currently hard-codes font-size: 0.95rem in the .docs-content details summary
selector; replace the fixed value with font-size: inherit so the <summary>
inherits surrounding document typography and stays consistent when base sizes
change (update the .docs-content details summary declaration to remove 0.95rem
and use inherit).
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@content/docs/getting-started/_index.md`:
- Line 19: Fix the stray asterisk in the second list item: locate the line
containing "2. [Create Component Versions]({{< relref
"create-component-version.md" >}})*- Bundle and store your software artifacts"
and remove the extraneous "*" so the line reads "...}}) - Bundle and store your
software artifacts" (i.e., ensure there's just a space and a hyphen after the
closing ref).

In `@content/docs/overview/_index.md`:
- Line 11: The intro sentence "Discover the Open Component Model (OCM) - a model
and toolkit for a secure delivery for sovereign clouds." is awkward and repeats
"for"; replace it with a clearer phrasing such as "Discover the Open Component
Model (OCM) — a model and toolkit for secure delivery in sovereign clouds." to
fix grammar and improve flow.

---

Nitpick comments:
In `@assets/scss/common/_components.scss`:
- Around line 115-117: The summary rule currently hard-codes font-size: 0.95rem
in the .docs-content details summary selector; replace the fixed value with
font-size: inherit so the <summary> inherits surrounding document typography and
stays consistent when base sizes change (update the .docs-content details
summary declaration to remove 0.95rem and use inherit).

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: cc3f2284-32f5-4c31-93dc-261d4c795a36

📥 Commits

Reviewing files that changed from the base of the PR and between 06734ae and 9f08ec8.

📒 Files selected for processing (8)
  • .github/config/wordlist.txt
  • .gitignore
  • assets/scss/common/_components.scss
  • content/docs/concepts/_index.md
  • content/docs/getting-started/_index.md
  • content/docs/how-to/_index.md
  • content/docs/overview/_index.md
  • content/docs/tutorials/_index.md

Comment thread content/docs/getting-started/_index.md
Comment thread content/docs/overview/_index.md
morrison-sap and others added 2 commits March 5, 2026 16:55
On-behalf-of: Gerald Morrison (SAP) <gerald.morrison@sap.com>
Signed-off-by: Gerald Morrison (SAP) <gerald.morrison@sap.com>
@morri-son morri-son enabled auto-merge (squash) March 5, 2026 15:58
@morri-son morri-son merged commit a7fb3a4 into open-component-model:main Mar 5, 2026
10 checks passed
ocmbot Bot pushed a commit that referenced this pull request Mar 5, 2026
On-behalf-of: Gerald Morrison (SAP) <gerald.morrison@sap.com>

<!-- markdownlint-disable MD041 -->
#### What this PR does / why we need it
Add content to all section overview pages, that one can reach from the
central docs page:
https://deploy-preview-734--open-component-model.netlify.app/dev/docs/

Adopt the CSS so that the text in the details/summary section is aligned
with the other text on the page (currently it is shown larger as the
rest).

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

* **Documentation**
* Expanded Concepts, Getting Started, How-to, Overview, and Tutorials
sections with improved descriptions, prerequisites, and structured
learning paths.
  * Updated Getting Started sidebar navigation.

* **Style**
  * Enhanced styling for details and summary elements in documentation.

* **Chores**
  * Updated configuration files.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Signed-off-by: Gerald Morrison (SAP) <gerald.morrison@sap.com>
Co-authored-by: Gerald Morrison (SAP) <gerald.morrison@sap.com> a7fb3a4
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

area/documentation Documentation related kind/chore chore, maintenance, etc.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Rework getting started guides and align to common design and structure

3 participants