Skip to content

docs: use alert shortcode for remaining Note callouts - #4838

Merged
Catalin-Stratulat-Ericsson merged 1 commit into
kptdev:mainfrom
Nordix:docs-4533-note-alert-shortcode
Oct 29, 2026
Merged

Catalin-Stratulat-Ericsson merged 1 commit into
kptdev:mainfrom
Nordix:docs-4533-note-alert-shortcode

Conversation

@aravindtga

Copy link
Copy Markdown
Contributor

Description

  • What changed: Converts the four remaining plain-text / blockquote "Note:" callouts in the guides to the Docsy {{% alert title="Note" color="primary" %}} shortcode.
  • Why it's needed: These notes were rendering as plain paragraphs (or a blockquote) instead of highlighted callouts, inconsistent with the rest of the documentation where the alert shortcode is already the convention.
  • How it works: Each Note: / > Note: block is replaced with the Docsy alert shortcode, with title="Note" supplying the label so the leading "Note:" text is removed from the body.

Related Issue(s)

Type of Change

  • Documentation

Checklist

  • Code follows project style guidelines
  • Self-reviewed changes
  • Tests added/updated
  • Documentation added/updated
  • All tests and gating checks pass

AI Disclosure

  • I have used AI in the creation of this PR.

If so, please describe how:
- Kiro (Assisted-by tag in the commit) to convert the callouts to the alert shortcode and to draft this PR description.

Convert the four remaining plain-text "Note:" callouts in the guides to
the Docsy {{% alert %}} shortcode so they render as highlighted notes,
matching the convention already used elsewhere in the docs.

Files updated:
- guides/3-way-merge.md
- guides/krm-functions/containerizing.md (file-mode and published-image notes)
- guides/krm-functions/testing.md

Fixes kptdev#4533

Assisted-by: Kiro
Signed-off-by: Aravindhan Ayyanathan <aravindhan.a@est.tech>
@aravindtga
aravindtga requested review from a team and a balanced review from Copilot October 28, 2026 16:22
@netlify

netlify Bot commented Oct 28, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for kptdocs ready!

Name Link
🔨 Latest commit 7b60868
🔍 Latest deploy log https://app.netlify.com/projects/kptdocs/deploys/6ae2215a952eb0f1d7c9bc83
😎 Deploy Preview https://deploy-preview-4838--kptdocs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

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

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🟢 Approval recommended

There are no active review issues with the documentation callout standardization.

No open issues 🎉

What changed in this PR

Standardizes four guide notes using Docsy alert shortcodes so they appear as highlighted callouts, consistent with the documentation convention and issue #4533.

Changes:

  • Replaces plain-text and blockquote notes with alert shortcodes.
  • Uses title="Note" for the label and removes redundant “Note:” prefixes.
File Description
documentation/​content/​en/​guides/​krm-functions/​testing.md Converts the golden-test environment variable note to an alert.
documentation/​content/​en/​guides/​krm-functions/​containerizing.md Converts file-mode and container-image notes to alerts.
documentation/​content/​en/​guides/​3-way-merge.md Converts the merge-strategy blockquote note to an alert.

Review effort: Balanced

@aravindtga
aravindtga requested review from a team October 29, 2026 09:19

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

good stuff

@Catalin-Stratulat-Ericsson
Catalin-Stratulat-Ericsson merged commit 0bec06f into kptdev:main Oct 29, 2026
24 checks passed
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.

Use Note syntax in the documentation

4 participants