Skip to content

docs: avoid duplicate notifications in Goal issues#96

Merged
zolotokrylin merged 8 commits intomainfrom
docs/clarify-no-duplicate-notifications-in-goal-issues
Apr 8, 2026
Merged

docs: avoid duplicate notifications in Goal issues#96
zolotokrylin merged 8 commits intomainfrom
docs/clarify-no-duplicate-notifications-in-goal-issues

Conversation

@zolotokrylin
Copy link
Copy Markdown
Member

@zolotokrylin zolotokrylin commented Apr 8, 2026

Summary

  • Added a note in the Problem section to not post status updates back into the Goal issue — the link is sufficient.
  • Added a note in the Solution section to not repost PR notifications in the Goal issue — the PR→Problem→Goal chain already provides visibility.

Related

Summary by CodeRabbit

  • Documentation

    • Reformatted contributor guidelines with new guidance preventing status updates and notifications in goal issues.
    • Improved layout and readability across multiple documentation files including compensation, leave policy, and principles.
    • Added link references for contributor resources.
  • Chores

    • Updated development workflow configuration and markdown linting setup.
    • Added language server setup for markdown checking.

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai bot commented Apr 8, 2026

Caution

Review failed

Pull request was closed or merged during review

Walkthrough

Documentation formatting updates across multiple files (text reflowing, table alignment), added two [!IMPORTANT] callouts in CONTRIBUTING.md about Goal issue discussion guidelines, updated the markdown linting workflow to use reusable GitHub Actions with rumdl LSP configuration, and added local settings exclusions.

Changes

Cohort / File(s) Summary
Documentation Formatting
docs/ADVOCACY.md, docs/COMPENSATION.md, docs/PRINCIPLES.md, docs/APPLICATION_SUCCESS.md, docs/TRIAL.md
Table header/column alignment adjustments and text reflowing to improve readability; no substantive content changes.
CONTRIBUTING.md Enhancements
docs/CONTRIBUTING.md
Added two [!IMPORTANT] callouts restricting Problem status and PR updates in Goal issues; reflowed Wizard Browser Extension tip and other text blocks; added new Markdown link reference definition.
LEAVE_POLICY.md Updates
docs/LEAVE_POLICY.md
Reformatted leave policy tables for alignment; changed conflict clause from "signed agreement" to "agreement".
GitHub Actions & Tooling
.github/workflows/markdown_lint.yml, settings.json, .gitignore
Refactored markdown_lint workflow to trigger on PRs targeting main with draft filter; switched from direct rumdl binary to reusable composite actions with bun runtime; added new rumdl LSP server configuration and .claude/settings.local.json ignore rule.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

Suggested reviewers

  • angelicawill
  • georgeciubotaru
  • markholdex
  • williamrusdyputra
🚥 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 'docs: avoid duplicate notifications in Goal issues' directly aligns with the main functional change: adding notes to prevent duplicate status updates and PR notifications in Goal issues.
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 docs/clarify-no-duplicate-notifications-in-goal-issues

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.

Copy link
Copy Markdown
Contributor

@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: 2

🧹 Nitpick comments (2)
.claude/settings.local.json (1)

1-9: .local.json files typically shouldn't be committed.

Files with .local.* naming convention usually contain user-specific settings and belong in .gitignore.

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

In @.claude/settings.local.json around lines 1 - 9, Remove the committed
user-specific file ".claude/settings.local.json" from the repository history (or
at minimum delete it in the next commit), add a rule to .gitignore to prevent
".claude/*.local.*" (or specifically ".claude/settings.local.json") from being
committed going forward, and replace the committed file with a template/example
file (e.g., ".claude/settings.example.json") that documents the "permissions"
structure and allowed keys like "mcp__mcp-server-github__issue_read" and
"Bash(gh issue:*)" for others to copy into their local untracked file.
docs/CONTRIBUTING.md (1)

193-194: Keep list items on one line.

The line break doesn't improve readability. One line is simpler:

♻️ Simplify formatting
-1. [Link opened PR](https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword)
-   to the corresponding Problem (issue).
+1. [Link opened PR](https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword) to the corresponding Problem (issue).
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/CONTRIBUTING.md` around lines 193 - 194, The list item "1. [Link opened
PR](https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue-using-a-keyword)
to the corresponding Problem (issue)." should be a single line; remove the
manual line break between the link and "to the corresponding Problem (issue)" so
the entire list entry remains on one line in CONTRIBUTING.md.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In @.claude/settings.local.json:
- Around line 5-6: Current wildcard entries "Bash(gh issue:*)" and "Bash(gh
pr:*)" grant full write permissions; replace them with explicit read-only
command patterns (e.g., "Bash(gh issue:list)", "Bash(gh issue:view)", "Bash(gh
pr:list)", "Bash(gh pr:view)") or remove the wildcard and enumerate only the
safe read-only verbs so only listing/viewing PRs and issues are allowed rather
than create/edit/merge/close.

In `@docs/CONTRIBUTING.md`:
- Around line 148-151: Replace the inconsistent callout token "[!Note]" with the
all-caps variant "[!NOTE]" to match the rest of the file; update the specific
callout line containing the SSH-commit-signature note so it uses "[!NOTE]"
(preserving the existing link and text) to ensure uniform alert syntax
throughout CONTRIBUTING.md.

---

Nitpick comments:
In @.claude/settings.local.json:
- Around line 1-9: Remove the committed user-specific file
".claude/settings.local.json" from the repository history (or at minimum delete
it in the next commit), add a rule to .gitignore to prevent ".claude/*.local.*"
(or specifically ".claude/settings.local.json") from being committed going
forward, and replace the committed file with a template/example file (e.g.,
".claude/settings.example.json") that documents the "permissions" structure and
allowed keys like "mcp__mcp-server-github__issue_read" and "Bash(gh issue:*)"
for others to copy into their local untracked file.

In `@docs/CONTRIBUTING.md`:
- Around line 193-194: The list item "1. [Link opened
PR](https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue-using-a-keyword)
to the corresponding Problem (issue)." should be a single line; remove the
manual line break between the link and "to the corresponding Problem (issue)" so
the entire list entry remains on one line in CONTRIBUTING.md.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 7be60f98-8f87-4be2-8142-d5d4c92210e2

📥 Commits

Reviewing files that changed from the base of the PR and between 67d9502 and 8c6c26a.

📒 Files selected for processing (2)
  • .claude/settings.local.json
  • docs/CONTRIBUTING.md

@holdex
Copy link
Copy Markdown

holdex bot commented Apr 8, 2026

Time Submission Status

Member Status Time Action Last Update
zolotokrylin ✅ Submitted 1h Update time Apr 8, 2026, 6:09 AM

You can submit time with the command. Example:

@holdex pr submit-time 15m

See available commands to help comply with our Guidelines.

@zolotokrylin
Copy link
Copy Markdown
Member Author

@holdex pr submit-time 35m

Copy link
Copy Markdown
Contributor

@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)
docs/CONTRIBUTING.md (1)

161-164: ⚠️ Potential issue | 🟡 Minor

Use consistent callout token casing ([!NOTE]).

[!Note] is inconsistent with the rest of this file’s callout style.

Suggested fix
-> [!Note] We recommend signing commits using an
+> [!NOTE]
+> We recommend signing commits using an
 > [SSH key](https://docs.github.com/en/authentication/managing-commit-signature-verification/about-commit-signature-verification#ssh-commit-signature-verification).
 > Ensure your Git version supports SSH signature verification (Git 2.34 or
 > later).
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/CONTRIBUTING.md` around lines 161 - 164, The callout token `[!Note]` is
inconsistent with the rest of the file’s callout style; find the instance of the
callout token (the string `[!Note]`) and change it to the uppercase form
`[!NOTE]` so it matches other callouts in the document and preserves formatting
around the callout block.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/CONTRIBUTING.md`:
- Around line 103-111: The blockquote chain containing the "[!NOTE]" and
"[!IMPORTANT]" callouts has a stray blank line that breaks the contiguous ">"
chain and triggers MD028; fix it by removing the empty line between the two
callout blocks or by prefixing the separator line with ">" so the blockquote
markers remain contiguous (edit the block that starts with "[!NOTE]" and the
following "[!IMPORTANT]" callout to ensure every line in the quote begins with
">" or has no blank line between them).

---

Duplicate comments:
In `@docs/CONTRIBUTING.md`:
- Around line 161-164: The callout token `[!Note]` is inconsistent with the rest
of the file’s callout style; find the instance of the callout token (the string
`[!Note]`) and change it to the uppercase form `[!NOTE]` so it matches other
callouts in the document and preserves formatting around the callout block.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 1bdd2410-255d-420a-9a1a-4124a2bda08f

📥 Commits

Reviewing files that changed from the base of the PR and between 8c6c26a and 8c7e249.

📒 Files selected for processing (7)
  • docs/ADVOCACY.md
  • docs/APPLICATION_SUCCESS.md
  • docs/COMPENSATION.md
  • docs/CONTRIBUTING.md
  • docs/LEAVE_POLICY.md
  • docs/PRINCIPLES.md
  • docs/TRIAL.md
✅ Files skipped from review due to trivial changes (6)
  • docs/APPLICATION_SUCCESS.md
  • docs/PRINCIPLES.md
  • docs/ADVOCACY.md
  • docs/COMPENSATION.md
  • docs/LEAVE_POLICY.md
  • docs/TRIAL.md

zolotokrylin and others added 6 commits April 8, 2026 13:48
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Signed-off-by: Vadim <vadim@holdex.io>
@zolotokrylin zolotokrylin merged commit 1a87a8d into main Apr 8, 2026
2 of 3 checks passed
@zolotokrylin zolotokrylin deleted the docs/clarify-no-duplicate-notifications-in-goal-issues branch April 8, 2026 06:09
@zolotokrylin
Copy link
Copy Markdown
Member Author

@holdex pr submit-time 1h 15m

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.

1 participant