Skip to content

Add contributing guidelines to repos#75

Open
cdunster wants to merge 8 commits intomainfrom
add-contributing-guidelines
Open

Add contributing guidelines to repos#75
cdunster wants to merge 8 commits intomainfrom
add-contributing-guidelines

Conversation

@cdunster
Copy link
Contributor

@cdunster cdunster commented Mar 17, 2026

Add a function to create a CONTRIBUTING.md guidelines file in the repos that use the release integration tooling.

Summary by CodeRabbit

  • New Features

    • CONTRIBUTING.md can now be automatically added to repositories during project setup with repository-specific customization.
  • Documentation

    • Comprehensive CONTRIBUTING.md included, covering getting started, commit and PR guidelines, review workflow, issue reporting, development setup, Code of Conduct, and license terms.

@cdunster cdunster self-assigned this Mar 17, 2026
@coderabbitai
Copy link

coderabbitai bot commented Mar 17, 2026

Warning

Rate limit exceeded

@cdunster has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 3 minutes and 33 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 5458746b-1558-495d-bfd4-d5f7132b12de

📥 Commits

Reviewing files that changed from the base of the PR and between f781017 and 6f04744.

📒 Files selected for processing (1)
  • files/CONTRIBUTING.md

Walkthrough

Adds a CONTRIBUTING.md documentation file and a Go-based automation that embeds the template and deploys it (with repository-name substitution) to repositories via a new AddContributingGuide function invoked across repository setup flows.

Changes

Cohort / File(s) Summary
Contributing Guide Documentation
files/CONTRIBUTING.md
Adds a new CONTRIBUTING.md with Getting Started, commit guidelines (conventional/atomic/rebase), PR process, issue reporting, development setup, Code of Conduct, and license terms.
Guide Deployment Automation
main.go
Embeds the CONTRIBUTING.md template, introduces func AddContributingGuide(ctx *pulumi.Context, name string, repository *github.Repository) error, and calls it across repository setup paths to create/update CONTRIBUTING.md with repository-name substitution.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 66.67% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (2 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and concisely summarizes the main change: adding contributing guidelines to repositories.

✏️ 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 add-contributing-guidelines
📝 Coding Plan
  • Generate coding plan for human review comments

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

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

## Getting Started

1. Fork the repository
2. Create a feature branch from `main`
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Should this be develop or "the default branch"

Copy link
Member

Choose a reason for hiding this comment

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

The default branch, the one that shows up on the homepage of the repository above the files in the branch selection drop down.

Copy link
Contributor

Choose a reason for hiding this comment

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

Except for the holochain repo, which isn't managed by Pulumi, the default branch is main in nearly all repos. Could say "the default branch (usually main)".

Copy link
Contributor Author

@cdunster cdunster Mar 18, 2026

Choose a reason for hiding this comment

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

Done in 5a64278

@github-actions
Copy link

github-actions bot commented Mar 17, 2026

🍹 preview on holochain/holochain/github

Pulumi report

View in Pulumi Cloud

  Previewing update (holochain/github)

View Live: https://app.pulumi.com/holochain/holochain/github/previews/20e206fb-012c-4b69-8129-52c73ccb148f

pulumi:pulumi:Stack: (same)
  [urn=urn:pulumi:github::holochain::pulumi:pulumi:Stack::holochain-github]
  + github:index/repositoryFile:RepositoryFile: (create)
      [urn=urn:pulumi:github::holochain::github:index/repositoryFile:RepositoryFile::influxive-contributing-md]
      [provider=urn:pulumi:github::holochain::pulumi:providers:github::default_6_11_0::dce38a79-6242-43ba-a5ff-26fae2b6f93c]
      autocreateBranch            : false
      autocreateBranchSourceBranch: "main"
      branch                      : "main"
      commitAuthor                : "Holochain Repository Automation"
      commitEmail                 : "hra@holochain.org"
      commitMessage               : "chore: add shared CONTRIBUTING.md"
      content                     : "# Contributing to influxive

Thank you for your interest in contributing to influxive!
..."
      file                        : "CONTRIBUTING.md"
      overwriteOnCreate           : true
      repository                  : "influxive"
  + github:index/repositoryFile:RepositoryFile: (create)
      [urn=urn:pulumi:github::holochain::github:index/repositoryFile:RepositoryFile::tx5-contributing-md]
      [provider=urn:pulumi:github::holochain::pulumi:providers:github::default_6_11_0::dce38a79-6242-43ba-a5ff-26fae2b6f93c]
      autocreateBranch            : false
      autocreateBranchSourceBranch: "main"
      branch                      : "main"
      commitAuthor                : "Holochain Repository Automation"
      commitEmail                 : "hra@holochain.org"
      commitMessage               : "chore: add shared CONTRIBUTING.md"
      content                     : "# Contributing to tx5

Thank you for your interest in contributing to tx5!
..."
      file                        : "CONTRIBUTING.md"
      overwriteOnCreate           : true
      repository                  : "tx5"
  + github:index/repositoryFile:RepositoryFile: (create)
      [urn=urn:pulumi:github::holochain::github:index/repositoryFile:RepositoryFile::sbd-contributing-md]
      [provider=urn:pulumi:github::holochain::pulumi:providers:github::default_6_11_0::dce38a79-6242-43ba-a5ff-26fae2b6f93c]
      autocreateBranch            : false
      autocreateBranchSourceBranch: "main"
      branch                      : "main"
      commitAuthor                : "Holochain Repository Automation"
      commitEmail                 : "hra@holochain.org"
      commitMessage               : "chore: add shared CONTRIBUTING.md"
      content                     : "# Contributing to sbd

Thank you for your interest in contributing to sbd!
..."
      file                        : "CONTRIBUTING.md"
      overwriteOnCreate           : true
      repository                  : "sbd"
  + github:index/repositoryFile:RepositoryFile: (create)
      [urn=urn:pulumi:github::holochain::github:index/repositoryFile:RepositoryFile::holochain-serialization-contributing-md]
      [provider=urn:pulumi:github::holochain::pulumi:providers:github::default_6_11_0::dce38a79-6242-43ba-a5ff-26fae2b6f93c]
      autocreateBranch            : false
      autocreateBranchSourceBranch: "main"
      branch                      : "main"
      commitAuthor                : "Holochain Repository Automation"
      commitEmail                 : "hra@holochain.org"
      commitMessage               : "chore: add shared CONTRIBUTING.md"
      content                     : "# Contributing to holochain-serialization

Thank you for your interest in contributing to holochain-serialization!
..."
      file                        : "CONTRIBUTING.md"
      overwriteOnCreate           : true
      repository                  : "holochain-serialization"
  + github:index/repositoryFile:RepositoryFile: (create)
      [urn=urn:pulumi:github::holochain::github:index/repositoryFile:RepositoryFile::holochain-wasmer-contributing-md]
      [provider=urn:pulumi:github::holochain::pulumi:providers:github::default_6_11_0::dce38a79-6242-43ba-a5ff-26fae2b6f93c]
      autocreateBranch            : false
      autocreateBranchSourceBranch: "main"
      branch                      : "main"
      commitAuthor                : "Holochain Repository Automation"
      commitEmail                 : "hra@holochain.org"
      commitMessage               : "chore: add shared CONTRIBUTING.md"
      content                     : "# Contributing to holochain-wasmer

Thank you for your interest in contributing to holochain-wasmer!
..."
      file                        : "CONTRIBUTING.md"
      overwriteOnCreate           : true
      repository                  : "holochain-wasmer"
  + github:index/repositoryFile:RepositoryFile: (create)
      [urn=urn:pulumi:github::holochain::github:index/repositoryFile:RepositoryFile::wind-tunnel-contributing-md]
      [provider=urn:pulumi:github::holochain::pulumi:providers:github::default_6_11_0::dce38a79-6242-43ba-a5ff-26fae2b6f93c]
      autocreateBranch            : false
      autocreateBranchSourceBranch: "main"
      branch                      : "main"
      commitAuthor                : "Holochain Repository Automation"
      commitEmail                 : "hra@holochain.org"
      commitMessage               : "chore: add shared CONTRIBUTING.md"
      content                     : "# Contributing to wind-tunnel

Thank you for your interest in contributing to wind-tunnel!
..."
      file                        : "CONTRIBUTING.md"
      overwriteOnCreate           : true
      repository                  : "wind-tunnel"
  + github:index/repositoryFile:RepositoryFile: (create)
      [urn=urn:pulumi:github::holochain::github:index/repositoryFile:RepositoryFile::lair-contributing-md]
      [provider=urn:pulumi:github::holochain::pulumi:providers:github::default_6_11_0::dce38a79-6242-43ba-a5ff-26fae2b6f93c]
      autocreateBranch            : false
      autocreateBranchSourceBranch: "main"
      branch                      : "main"
      commitAuthor                : "Holochain Repository Automation"
      commitEmail                 : "hra@holochain.org"
      commitMessage               : "chore: add shared CONTRIBUTING.md"
      content                     : "# Contributing to lair

Thank you for your interest in contributing to lair!
..."
      file                        : "CONTRIBUTING.md"
      overwriteOnCreate           : true
      repository                  : "lair"
  + github:index/repositoryFile:RepositoryFile: (create)
      [urn=urn:pulumi:github::holochain::github:index/repositoryFile:RepositoryFile::hc-chc-service-contributing-md]
      [provider=urn:pulumi:github::holochain::pulumi:providers:github::default_6_11_0::dce38a79-6242-43ba-a5ff-26fae2b6f93c]
      autocreateBranch            : false
      autocreateBranchSourceBranch: "main"
      branch                      : "main"
      commitAuthor                : "Holochain Repository Automation"
      commitEmail                 : "hra@holochain.org"
      commitMessage               : "chore: add shared CONTRIBUTING.md"
      content                     : "# Contributing to hc-chc-service

Thank you for your interest in contributing to hc-chc-service!
..."
      file                        : "CONTRIBUTING.md"
      overwriteOnCreate           : true
      repository                  : "hc-chc-service"
  + github:index/repositoryFile:RepositoryFile: (create)
      [urn=urn:pulumi:github::holochain::github:index/repositoryFile:RepositoryFile::kitsune2-contributing-md]
      [provider=urn:pulumi:github::holochain::pulumi:providers:github::default_6_11_0::dce38a79-6242-43ba-a5ff-26fae2b6f93c]
      autocreateBranch            : false
      autocreateBranchSourceBranch: "main"
      branch                      : "main"
      commitAuthor                : "Holochain Repository Automation"
      commitEmail                 : "hra@holochain.org"
      commitMessage               : "chore: add shared CONTRIBUTING.md"
      content                     : "# Contributing to kitsune2

Thank you for your interest in contributing to kitsune2!
..."
      file                        : "CONTRIBUTING.md"
      overwriteOnCreate           : true
      repository                  : "kitsune2"
  + github:index/repositoryFile:RepositoryFile: (create)
      [urn=urn:pulumi:github::holochain::github:index/repositoryFile:RepositoryFile::scaffolding-contributing-md]
      [provider=urn:pulumi:github::holochain::pulumi:providers:github::default_6_11_0::dce38a79-6242-43ba-a5ff-26fae2b6f93c]
      autocreateBranch            : false
      autocreateBranchSourceBranch: "main"
      branch                      : "main"
      commitAuthor                : "Holochain Repository Automation"
      commitEmail                 : "hra@holochain.org"
      commitMessage               : "chore: add shared CONTRIBUTING.md"
      content                     : "# Contributing to scaffolding

Thank you for your interest in contributing to scaffolding!
..."
      file                        : "CONTRIBUTING.md"
      overwriteOnCreate           : true
      repository                  : "scaffolding"
  + github:index/repositoryFile:RepositoryFile: (create)
      [urn=urn:pulumi:github::holochain::github:index/repositoryFile:RepositoryFile::hc-http-gw-contributing-md]
      [provider=urn:pulumi:github::holochain::pulumi:providers:github::default_6_11_0::dce38a79-6242-43ba-a5ff-26fae2b6f93c]
      autocreateBranch            : false
      autocreateBranchSourceBranch: "main"
      branch                      : "main"
      commitAuthor                : "Holochain Repository Automation"
      commitEmail                 : "hra@holochain.org"
      commitMessage               : "chore: add shared CONTRIBUTING.md"
      content                     : "# Contributing to hc-http-gw

Thank you for your interest in contributing to hc-http-gw!
..."
      file                        : "CONTRIBUTING.md"
      overwriteOnCreate           : true
      repository                  : "hc-http-gw"
  + github:index/repositoryFile:RepositoryFile: (create)
      [urn=urn:pulumi:github::holochain::github:index/repositoryFile:RepositoryFile::serde-json-contributing-md]
      [provider=urn:pulumi:github::holochain::pulumi:providers:github::default_6_11_0::dce38a79-6242-43ba-a5ff-26fae2b6f93c]
      autocreateBranch            : false
      autocreateBranchSourceBranch: "main"
      branch                      : "main"
      commitAuthor                : "Holochain Repository Automation"
      commitEmail                 : "hra@holochain.org"
      commitMessage               : "chore: add shared CONTRIBUTING.md"
      content                     : "# Contributing to serde-json

Thank you for your interest in contributing to serde-json!
..."
      file                        : "CONTRIBUTING.md"
      overwriteOnCreate           : true
      repository                  : "serde-json"
  + github:index/repositoryFile:RepositoryFile: (create)
      [urn=urn:pulumi:github::holochain::github:index/repositoryFile:RepositoryFile::rand-utf8-contributing-md]
      [provider=urn:pulumi:github::holochain::pulumi:providers:github::default_6_11_0::dce38a79-6242-43ba-a5ff-26fae2b6f93c]
      autocreateBranch            : false
      autocreateBranchSourceBranch: "main"
      branch                      : "main"
      commitAuthor                : "Holochain Repository Automation"
      commitEmail                 : "hra@holochain.org"
      commitMessage               : "chore: add shared CONTRIBUTING.md"
      content                     : "# Contributing to rand-utf8

Thank you for your interest in contributing to rand-utf8!
..."
      file                        : "CONTRIBUTING.md"
      overwriteOnCreate           : true
      repository                  : "rand-utf8"
  + github:index/repositoryFile:RepositoryFile: (create)
      [urn=urn:pulumi:github::holochain::github:index/repositoryFile:RepositoryFile::hc-auth-server-contributing-md]
      [provider=urn:pulumi:github::holochain::pulumi:providers:github::default_6_11_0::dce38a79-6242-43ba-a5ff-26fae2b6f93c]
      autocreateBranch            : false
      autocreateBranchSourceBranch: "main"
      branch                      : "main"
      commitAuthor                : "Holochain Repository Automation"
      commitEmail                 : "hra@holochain.org"
      commitMessage               : "chore: add shared CONTRIBUTING.md"
      content                     : "# Contributing to hc-auth-server

Thank you for your interest in contributing to hc-auth-server!
..."
      file                        : "CONTRIBUTING.md"
      overwriteOnCreate           : true
      repository                  : "hc-auth-server"
Resources:
  + 14 to create
  377 unchanged
  

Copy link

@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.

🧹 Nitpick comments (1)
files/CONTRIBUTING.md (1)

17-18: Minor: Capitalize "Markdown" as a proper noun.

"Markdown" refers to the markup language and is typically capitalized.

📝 Suggested fix
 - Use [conventional commits](https://www.conventionalcommits.org/) for commit
-  messages. You can also use markdown, especially in the body
+  messages. You can also use Markdown, especially in the body
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@files/CONTRIBUTING.md` around lines 17 - 18, Update the sentence fragment
"Use [conventional commits](https://www.conventionalcommits.org/) for commit
messages. You can also use markdown, especially in the body" to capitalize
"Markdown" as a proper noun (i.e., change "markdown" to "Markdown") so the line
reads that Markdown can be used in the body; keep the rest of the sentence and
link unchanged.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@files/CONTRIBUTING.md`:
- Around line 17-18: Update the sentence fragment "Use [conventional
commits](https://www.conventionalcommits.org/) for commit messages. You can also
use markdown, especially in the body" to capitalize "Markdown" as a proper noun
(i.e., change "markdown" to "Markdown") so the line reads that Markdown can be
used in the body; keep the rest of the sentence and link unchanged.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 5aaef698-7d4c-40d3-9df9-849973ac6795

📥 Commits

Reviewing files that changed from the base of the PR and between 508364f and e68e15c.

📒 Files selected for processing (2)
  • files/CONTRIBUTING.md
  • main.go

## Getting Started

1. Fork the repository
2. Create a feature branch from `main`
Copy link
Member

Choose a reason for hiding this comment

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

The default branch, the one that shows up on the homepage of the repository above the files in the branch selection drop down.

a re-approval is required
- Squash all `fixup!` commits and clean-up the commit history before merging
into the base branch. You can do this at the same time as rebasing with
`git rebase --autosquash <base_branch>`
Copy link
Member

Choose a reason for hiding this comment

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

This doesn't work for me, I always use -i at the same time. Maybe I'm doing something wrong there :)

Copy link
Contributor

Choose a reason for hiding this comment

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

It works for me on macos and Linux. You must be doing something wrong! 😛

Copy link
Contributor Author

Choose a reason for hiding this comment

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

What version of Git are you on @ThetaSinner? It seems that the --interactive requirement was removed in Git v2.44.0. Released in January 2025, maybe you should update but maybe I should also add this note in the doc?

Copy link
Contributor Author

@cdunster cdunster Mar 18, 2026

Choose a reason for hiding this comment

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

Added a note in 103a55e

## Getting Started

1. Fork the repository
2. Create a feature branch from `main`
Copy link
Contributor

Choose a reason for hiding this comment

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

Except for the holochain repo, which isn't managed by Pulumi, the default branch is main in nearly all repos. Could say "the default branch (usually main)".

a re-approval is required
- Squash all `fixup!` commits and clean-up the commit history before merging
into the base branch. You can do this at the same time as rebasing with
`git rebase --autosquash <base_branch>`
Copy link
Contributor

Choose a reason for hiding this comment

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

It works for me on macos and Linux. You must be doing something wrong! 😛

@holochain holochain deleted a comment from cocogitto-bot bot Mar 18, 2026
@holochain holochain deleted a comment from cocogitto-bot bot Mar 18, 2026
feat: add contributing guide to repos that support release integration
@holochain holochain deleted a comment from cocogitto-bot bot Mar 18, 2026
@cdunster cdunster marked this pull request as ready for review March 18, 2026 18:27
@cdunster cdunster requested review from ThetaSinner and jost-s March 18, 2026 18:27
Copy link
Contributor

@jost-s jost-s left a comment

Choose a reason for hiding this comment

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

👌

Copy link

@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.

Actionable comments posted: 1

🧹 Nitpick comments (1)
main.go (1)

112-114: Reduce drift risk by bundling release-integration setup with contributing-guide setup.

This repeated two-call sequence is easy to miss in future repo additions. Consider a single helper that does both, then call that helper everywhere.

♻️ Proposed refactor
+func AddReleaseIntegrationSupportWithContributingGuide(ctx *pulumi.Context, cfg *config.Config, name string, repository *github.Repository) error {
+	if err := AddReleaseIntegrationSupport(ctx, cfg, name, repository); err != nil {
+		return err
+	}
+	return AddContributingGuide(ctx, name, repository)
+}
-		if err = AddReleaseIntegrationSupport(ctx, conf, "tx5", tx5); err != nil {
-			return err
-		}
-		if err = AddContributingGuide(ctx, "tx5", tx5); err != nil {
+		if err = AddReleaseIntegrationSupportWithContributingGuide(ctx, conf, "tx5", tx5); err != nil {
 			return err
 		}

Also applies to: 164-166, 321-323, 351-353, 381-383, 411-413, 441-443, 471-473, 587-589, 659-661, 851-853, 1008-1010, 1035-1037, 1368-1370

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

In `@main.go` around lines 112 - 114, The two-call sequence that invokes
AddContributingGuide(...) followed immediately by the release-integration setup
is repeated across the codebase and risks drift; create a single helper (e.g.,
AddContributingAndReleaseSetup(ctx, repoName, repoConfig)) that internally calls
AddContributingGuide(...) and the existing release-integration function (the
release-integration setup currently paired with AddContributingGuide calls) and
returns an error if either fails, preserving existing error handling; then
replace each pair of calls (instances around AddContributingGuide(...) at lines
like the shown one and the other listed locations) with a single call to
AddContributingAndReleaseSetup(...) to centralize behavior.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@files/CONTRIBUTING.md`:
- Line 18: Update the user-facing copy that reads "You can also use markdown,
especially in the body" to capitalize the proper noun "Markdown" (i.e., change
"markdown" to "Markdown") so the CONTRIBUTING guidance consistently uses the
correct form.

---

Nitpick comments:
In `@main.go`:
- Around line 112-114: The two-call sequence that invokes
AddContributingGuide(...) followed immediately by the release-integration setup
is repeated across the codebase and risks drift; create a single helper (e.g.,
AddContributingAndReleaseSetup(ctx, repoName, repoConfig)) that internally calls
AddContributingGuide(...) and the existing release-integration function (the
release-integration setup currently paired with AddContributingGuide calls) and
returns an error if either fails, preserving existing error handling; then
replace each pair of calls (instances around AddContributingGuide(...) at lines
like the shown one and the other listed locations) with a single call to
AddContributingAndReleaseSetup(...) to centralize behavior.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 28208112-f4ad-4a31-ab22-f0c1ae460693

📥 Commits

Reviewing files that changed from the base of the PR and between e68e15c and 1b28e9f.

📒 Files selected for processing (2)
  • files/CONTRIBUTING.md
  • main.go

them clean. To help with keeping them clean, follow these principles:

- Use [conventional commits](https://www.conventionalcommits.org/) for commit
messages. You can also use markdown, especially in the body
Copy link

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Capitalize Markdown in commit guidance.

Use the proper noun form for consistency in user-facing docs.

✏️ Proposed fix
-- messages. You can also use markdown, especially in the body
+- messages. You can also use Markdown, especially in the body
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
messages. You can also use markdown, especially in the body
messages. You can also use Markdown, especially in the body
🧰 Tools
🪛 LanguageTool

[uncategorized] ~18-~18: Did you mean the formatting language “Markdown” (= proper noun)?
Context: ...for commit messages. You can also use markdown, especially in the body - Keep commits ...

(MARKDOWN_NNP)

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

In `@files/CONTRIBUTING.md` at line 18, Update the user-facing copy that reads
"You can also use markdown, especially in the body" to capitalize the proper
noun "Markdown" (i.e., change "markdown" to "Markdown") so the CONTRIBUTING
guidance consistently uses the correct form.

Copy link

@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.

Actionable comments posted: 1

♻️ Duplicate comments (1)
files/CONTRIBUTING.md (1)

18-18: ⚠️ Potential issue | 🟡 Minor

Capitalize “Markdown” in commit guidance.

Line 18 uses “markdown”; use the proper noun “Markdown” for consistency in user-facing docs.

✏️ Proposed fix
-  messages. You can also use markdown, especially in the body
+  messages. You can also use Markdown, especially in the body
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@files/CONTRIBUTING.md` at line 18, Change the lowercase word "markdown" in
the CONTRIBUTING.md text (the instance shown in the diff) to the proper noun
"Markdown" so the user-facing guidance uses correct capitalization; locate the
token "markdown" and replace it with "Markdown".
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@files/CONTRIBUTING.md`:
- Around line 42-44: Update the sentence about rebasing after approval to
clarify that only UI rebases always preserve approvals and that local rebases
may require re-approval depending on the repository's branch protection setting;
reword the existing lines to something like: "After an approval, rebase on the
base branch. Rebasing via the GitHub UI preserves approvals. However, local
rebases may trigger re-approval depending on the repository's branch protection
settings (the 'dismiss stale pull request approvals' option)." Make sure the new
text replaces the current paragraph that discusses UI vs local rebase behavior
and explicitly mention the "dismiss stale pull request approvals" setting.

---

Duplicate comments:
In `@files/CONTRIBUTING.md`:
- Line 18: Change the lowercase word "markdown" in the CONTRIBUTING.md text (the
instance shown in the diff) to the proper noun "Markdown" so the user-facing
guidance uses correct capitalization; locate the token "markdown" and replace it
with "Markdown".

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 2b8cd8ea-2fb9-43ef-9393-48c9cb6e67db

📥 Commits

Reviewing files that changed from the base of the PR and between 1b28e9f and f781017.

📒 Files selected for processing (1)
  • files/CONTRIBUTING.md

Comment on lines +42 to +44
- After an approval, rebase on the base branch. If this is done via the GitHub
UI then no re-approval will be needed. However, if this is done locally then
a re-approval is required
Copy link

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

🧩 Analysis chain

🌐 Web query:

In GitHub pull requests, does rebasing via the GitHub UI always avoid requiring re-approval, or does this depend on branch protection settings (e.g., dismiss stale approvals)?

💡 Result:

Rebasing a pull request branch via the GitHub UI (using "Update with rebase" or "Rebase branch") does not always require re-approval. It depends on the branch protection settings, specifically the "Dismiss stale pull request approvals when new commits are pushed" option. If this setting is enabled on the base branch's protection rule, pushing new commits (including those from a UI rebase, which rewrites history and force-pushes) that are considered "reviewable" will dismiss existing approvals, requiring re-approval. However, GitHub treats UI-performed rebases (and merges from the base branch) as non-reviewable updates. These do not trigger dismissal of approvals, preserving them even with the dismiss stale setting enabled. Manual pushes, local rebases with force-push, or other web changes (e.g., applying suggestions) are treated as reviewable and dismiss approvals. This behavior is confirmed by user observations and expert explanations: UI rebase onto the base branch avoids dismissal, while manual rebases do not, due to GitHub's special handling of its own sync tools.

Citations:


Clarify that re-approval requirement for local rebases depends on repository settings.

Lines 42-44 are mostly accurate based on GitHub's actual behavior: UI-performed rebases preserve approvals (GitHub treats them as non-reviewable), while local rebases may trigger approval dismissal—but only if the repository has enabled the "dismiss stale pull request approvals" branch protection setting. Reword to clarify the local rebase behavior is settings-dependent, not absolute; however, avoid implying the GitHub UI rebase is also conditional, since it consistently preserves approvals regardless of branch protection settings.

✏️ Suggested reword

Instead of the proposed fix, consider:

- After an approval, rebase on the base branch. Rebasing via the GitHub UI 
- preserves approvals. However, local rebases may trigger re-approval depending
- on the repository's branch protection settings (the "dismiss stale pull request
- approvals" option).
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@files/CONTRIBUTING.md` around lines 42 - 44, Update the sentence about
rebasing after approval to clarify that only UI rebases always preserve
approvals and that local rebases may require re-approval depending on the
repository's branch protection setting; reword the existing lines to something
like: "After an approval, rebase on the base branch. Rebasing via the GitHub UI
preserves approvals. However, local rebases may trigger re-approval depending on
the repository's branch protection settings (the 'dismiss stale pull request
approvals' option)." Make sure the new text replaces the current paragraph that
discusses UI vs local rebase behavior and explicitly mention the "dismiss stale
pull request approvals" setting.

@cocogitto-bot
Copy link

cocogitto-bot bot commented Mar 18, 2026

❌ Found 2 compliant commit and 6 non-compliant commits in 885d3be...6f04744.

Commit ee472ff by @cdunster is not conform to the conventional commit specification :

  • message: `fixup! feat: add CONTRIBUTING.md template file to repos

Co-authored-by: Jost 28270981+jost-s@users.noreply.github.com`

  • cause:
    Missing commit type separator `:`
    
    Caused by:
         --> 1:7
          |
        1 | fixup! feat: add CONTRIBUTING.md template file to repos
          |       ^---
          |
          = expected type_separator
    

Commit 5a64278 by @cdunster is not conform to the conventional commit specification :

  • message: fixup! feat: add CONTRIBUTING.md template file to repos
  • cause:
    Missing commit type separator `:`
    
    Caused by:
         --> 1:7
          |
        1 | fixup! feat: add CONTRIBUTING.md template file to repos
          |       ^---
          |
          = expected type_separator
    

Commit 103a55e by @cdunster is not conform to the conventional commit specification :

  • message: fixup! feat: add CONTRIBUTING.md template file to repos
  • cause:
    Missing commit type separator `:`
    
    Caused by:
         --> 1:7
          |
        1 | fixup! feat: add CONTRIBUTING.md template file to repos
          |       ^---
          |
          = expected type_separator
    

Commit 1b28e9f by @cdunster is not conform to the conventional commit specification :

  • message: `amend! feat: add contributing guide to the wind-tunnel repo

feat: add contributing guide to repos that support release integration`

  • cause:
    Missing commit type separator `:`
    
    Caused by:
         --> 1:7
          |
        1 | amend! feat: add contributing guide to the wind-tunnel repo
          |       ^---
          |
          = expected type_separator
    

Commit f781017 by @cdunster is not conform to the conventional commit specification :

  • message: fixup! feat: add CONTRIBUTING.md template file to repos
  • cause:
    Missing commit type separator `:`
    
    Caused by:
         --> 1:7
          |
        1 | fixup! feat: add CONTRIBUTING.md template file to repos
          |       ^---
          |
          = expected type_separator
    

Commit 6f04744 by @cdunster is not conform to the conventional commit specification :

  • message: fixup! feat: add CONTRIBUTING.md template file to repos
  • cause:
    Missing commit type separator `:`
    
    Caused by:
         --> 1:7
          |
        1 | fixup! feat: add CONTRIBUTING.md template file to repos
          |       ^---
          |
          = expected type_separator
    

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.

3 participants