Skip to content

docs(release): merge develop into main#223

Merged
bedatty merged 2 commits intomainfrom
develop
Apr 15, 2026
Merged

docs(release): merge develop into main#223
bedatty merged 2 commits intomainfrom
develop

Conversation

@bedatty
Copy link
Copy Markdown
Contributor

@bedatty bedatty commented Apr 15, 2026

Lerian

GitHub Actions Shared Workflows


Description

Type of Change

  • feat: New workflow or new input/output/step in an existing workflow
  • fix: Bug fix in a workflow (incorrect behavior, broken step, wrong condition)
  • perf: Performance improvement (e.g. caching, parallelism, reduced steps)
  • refactor: Internal restructuring with no behavior change
  • docs: Documentation only (README, docs/, inline comments)
  • ci: Changes to self-CI (workflows under .github/workflows/ that run on this repo)
  • chore: Dependency bumps, config updates, maintenance
  • test: Adding or updating tests
  • BREAKING CHANGE: Callers must update their configuration after this PR

Breaking Changes

None.

Testing

  • YAML syntax validated locally
  • Triggered a real workflow run on a caller repository using @develop or the beta tag
  • Verified all existing inputs still work with default values
  • Confirmed no secrets or tokens are printed in logs
  • Checked that unrelated workflows are not affected

Caller repo / workflow run:

Related Issues

Closes #

Summary by CodeRabbit

  • New Features

    • Added a new optional deployment_matrix_ref input parameter that allows controlling which Git reference is used when sourcing the deployment matrix configuration. This defaults to main but can be overridden as needed.
  • Documentation

    • Updated documentation to describe the updated deployment matrix sourcing behavior and new input parameter.

bedatty and others added 2 commits April 15, 2026 16:02
…fault resolution

Addresses CodeRabbit feedback on PR #221. The workflow no longer checks out
the manifest at the same ref as itself — it defaults to 'main' (via the
deployment_matrix_ref input) so manifest updates propagate to every caller
without bumping the pinned workflow tag.

- Lead paragraph: replace 'same pinned ref' description.
- Optional inputs table: add deployment_matrix_ref row.
- 'How it works' step 2: rewrite to reflect the new behavior and rationale.
…trix-ref

docs(gitops-update): document deployment_matrix_ref input
@bedatty bedatty requested a review from a team as a code owner April 15, 2026 19:40
@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Apr 15, 2026

Walkthrough

Updated workflow documentation and added a deployment_matrix_ref input parameter to decouple deployment matrix configuration sourcing from the pinned workflow ref, defaulting to main branch.

Changes

Cohort / File(s) Summary
Workflow Definition
.github/workflows/update-gitops.yml
Added optional input deployment_matrix_ref (string, default: main) to control the Git ref for deployment matrix sourcing.
Documentation
docs/gitops-update-workflow.md
Updated to describe decoupled checkout behavior where config/deployment-matrix.yml is sourced independently from the pinned workflow ref via the new input parameter.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Suggested labels

workflow, size/XS

🚥 Pre-merge checks | ✅ 1 | ❌ 2

❌ Failed checks (2 warnings)

Check name Status Explanation Resolution
Title check ⚠️ Warning The PR title 'docs(release): merge develop into main' is misleading. The changeset documents a workflow behavior change (deployment_matrix_ref input), not a generic develop-to-main merge. Revise title to reflect the actual change: 'docs(gitops-update): document deployment_matrix_ref input and main-default resolution' or similar.
Description check ⚠️ Warning The description omits the critical summary in the Description section. The Type of Change (docs) is marked, Testing is documented, but the Description placeholder remains empty. Fill the Description section to explain what this PR does, why the change was made, and which workflows are affected.
✅ Passed checks (1 passed)
Check name Status Explanation
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
  • Commit unit tests in branch develop

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

@lerian-studio lerian-studio added size/XS PR changes < 50 lines documentation Improvements or additions to documentation labels Apr 15, 2026
@lerian-studio
Copy link
Copy Markdown

🔍 Lint Analysis

Check Files Scanned Status
YAML Lint no changes ⏭️ skipped
Action Lint no changes ⏭️ skipped
Pinned Actions no changes ⏭️ skipped
Markdown Link Check 1 file(s) ✅ success
Spelling Check 1 file(s) ✅ success
Shell Check no changes ⏭️ skipped
README Check no changes ⏭️ skipped
Composite Schema no changes ⏭️ skipped
Deployment Matrix no changes ⏭️ skipped

🔍 View full scan logs

Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (2)
docs/gitops-update-workflow.md (2)

1-1: ⚠️ Potential issue | 🟠 Major

Add the required Lerian branding header.

The documentation file must start with the Lerian branding header before the workflow title.

📋 Proposed fix: Add branding header
+<table border="0" cellspacing="0" cellpadding="0">
+  <tr>
+    <td>[Lerian Logo]</td>
+    <td><h1>GitHub Actions Shared Workflows</h1></td>
+  </tr>
+</table>
+
+---
+
 # GitOps Update Workflow

As per coding guidelines: "Start with the Lerian branding header."

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/gitops-update-workflow.md` at line 1, This document is missing the
required Lerian branding header before the workflow title; open the file
containing the "# GitOps Update Workflow" heading and insert the mandated Lerian
branding header (the standardized branding block used across docs) immediately
above that top-level title so the branding appears first in the file and
preserves the existing content and markdown structure.

1-1: ⚠️ Potential issue | 🟠 Major

Rename file to match the workflow filename.

Per coding guidelines, the documentation file must have the exact same name as the workflow file with .md extension. The workflow is gitops-update.yml, so this file should be docs/gitops-update.md, not docs/gitops-update-workflow.md.

As per coding guidelines: "The documentation file in docs/ must have the exact same name as the workflow file with .md extension."

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/gitops-update-workflow.md` at line 1, Rename the documentation file from
docs/gitops-update-workflow.md to docs/gitops-update.md to match the workflow
filename gitops-update.yml; update any internal references (table of contents,
sidebar, links) that point to docs/gitops-update-workflow.md so they now
reference docs/gitops-update.md to keep naming consistent with the coding
guideline.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Outside diff comments:
In `@docs/gitops-update-workflow.md`:
- Line 1: This document is missing the required Lerian branding header before
the workflow title; open the file containing the "# GitOps Update Workflow"
heading and insert the mandated Lerian branding header (the standardized
branding block used across docs) immediately above that top-level title so the
branding appears first in the file and preserves the existing content and
markdown structure.
- Line 1: Rename the documentation file from docs/gitops-update-workflow.md to
docs/gitops-update.md to match the workflow filename gitops-update.yml; update
any internal references (table of contents, sidebar, links) that point to
docs/gitops-update-workflow.md so they now reference docs/gitops-update.md to
keep naming consistent with the coding guideline.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: ASSERTIVE

Plan: Pro

Run ID: 8c388cae-16c8-4e97-a3ad-cc291d20cffd

📥 Commits

Reviewing files that changed from the base of the PR and between 7982514 and 27f5954.

📒 Files selected for processing (1)
  • docs/gitops-update-workflow.md

@bedatty bedatty merged commit 788b3c6 into main Apr 15, 2026
17 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size/XS PR changes < 50 lines

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants