Skip to content

docs: add contribution templates and triage bot-generated PRs#251

Merged
teng-lin merged 4 commits intomainfrom
worktree-issue-249
Apr 5, 2026
Merged

docs: add contribution templates and triage bot-generated PRs#251
teng-lin merged 4 commits intomainfrom
worktree-issue-249

Conversation

@teng-lin
Copy link
Copy Markdown
Owner

@teng-lin teng-lin commented Apr 5, 2026

Summary

Triage Details

Audited recent contributions and identified bot-generated PRs based on:

Labeled as bot-generated:

Not labeled (established accounts using AI tools legitimately):

Closes #249

Test plan

  • bot-generated label created and applied to 5 items
  • Issue templates render in GitHub's "New Issue" form
  • PR template renders when opening a new PR
  • CONTRIBUTING.md quality section is clear and actionable

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation
    • Added standardized issue templates for bug reports and feature requests to collect reproduction steps, environment details, debug output, and expected/actual behavior; bug template includes a checklist and debug instructions
    • Introduced a pull request template with sections and checklist items for summary, related issues, testing, linting, type checks, and notes
    • Enhanced contribution guidelines with explicit PR quality expectations and linking requirements
    • Disabled creation of blank issues via repository settings

Add issue templates (bug report, feature request), PR template, and
PR quality expectations to CONTRIBUTING.md to reduce low-quality and
bot-generated contributions.

Closes #249

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Apr 5, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: e1eed17b-29d8-42df-90a2-16a9cdbd7e04

📥 Commits

Reviewing files that changed from the base of the PR and between 74ec98e and bec108b.

📒 Files selected for processing (1)
  • .github/ISSUE_TEMPLATE/bug_report.md
✅ Files skipped from review due to trivial changes (1)
  • .github/ISSUE_TEMPLATE/bug_report.md

📝 Walkthrough

Walkthrough

Added GitHub issue templates (bug report, feature request, config), a pull request template, and updated CONTRIBUTING.md with pull request quality expectations and testing/linking requirements for the notebooklm-py repository.

Changes

Cohort / File(s) Summary
Issue Templates
.github/ISSUE_TEMPLATE/bug_report.md, .github/ISSUE_TEMPLATE/feature_request.md, .github/ISSUE_TEMPLATE/config.yml
Add structured bug and feature issue templates; disable blank issues. Bug template collects reproduction steps, expected vs actual behavior, a fenced text block for error/traceback, debug instructions (notebooklm -vv), environment fields, and a checklist.
Pull Request Template
.github/PULL_REQUEST_TEMPLATE.md
Add standardized PR template with summary, optional Closes #<issue_number>, a "Changes" checklist, and a "Test Plan" checklist covering local testing, pytest, ruff, and mypy.
Contribution Guidelines
CONTRIBUTING.md
Add "Pull Request Quality Expectations": require PR→issue linkage, scrutiny of AI-assisted changes, duplicate-PR checks, evidence for critical severity, and proof of local testing aligned with PR checklist.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐇 I hopped through templates, tidy and neat,
I planted checkboxes beneath every sheet.
Bugs get steps, features get a plan,
PRs now ask where the issues began.
Hooray — a clean burrow for code to meet!

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Linked Issues check ⚠️ Warning The PR partially addresses issue #249 objectives by adding templates and updating CONTRIBUTING.md, but does not implement core requirements: no bot-generated label was created, no bot PRs were closed, and no account audit results are shown. Ensure the bot-generated label is created and applied to identified problematic PRs/issues as specified in issue #249, and document the audit findings and actions taken.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately summarizes the main changes: adding GitHub contribution templates (issue and PR templates) and addressing bot-generated PR triage, matching the file additions and CONTRIBUTING.md updates.
Out of Scope Changes check ✅ Passed All changes (issue templates, PR template, CONTRIBUTING.md updates) are directly related to the PR objectives of improving contribution workflows and triage processes defined in issue #249.
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 worktree-issue-249

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

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

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

Code Review

This pull request introduces standardized GitHub templates for bug reports, feature requests, and pull requests, while also updating the contribution guidelines with specific quality expectations. A review comment suggests adding a formatting check to the pull request template to ensure alignment with the project's existing linting and formatting requirements.


- [ ] I tested these changes locally
- [ ] Tests pass (`pytest`)
- [ ] Linting passes (`ruff check src/ tests/`)
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.

medium

The PR template should include a check for code formatting to align with the requirements specified in CONTRIBUTING.md (line 52). Additionally, using backticks for commands improves readability and consistency with the rest of the documentation.

Suggested change
- [ ] Linting passes (`ruff check src/ tests/`)
- [ ] Linting passes (ruff check src/ tests/)
- [ ] Formatting passes (ruff format --check src/ tests/)
References
  1. The CONTRIBUTING.md file (line 52) specifies the linting and formatting requirements that should be reflected in the PR checklist. (link)
  2. Project descriptions and templates should maintain a professional tone by avoiding informal abbreviations like 'etc.' and ensuring proper punctuation.

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

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

Already addressed in commit 81d63a4: added ruff format --check and mypy to the PR template checklist.

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.

Actionable comments posted: 1

🧹 Nitpick comments (1)
.github/PULL_REQUEST_TEMPLATE.md (1)

5-7: Consider making the issue reference more flexible.

The current template uses "Closes #<issue_number>", which assumes every PR closes an issue. However, CONTRIBUTING.md allows PRs that "clearly describe the problem being solved" without requiring a pre-existing issue. Consider making this section more flexible to accommodate both cases.

📝 Suggested refinement
 ## Related Issue
 
-Closes #<issue_number>
+Closes #<issue_number> (or describe the problem if no issue exists)
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In @.github/PULL_REQUEST_TEMPLATE.md around lines 5 - 7, The "## Related Issue"
section currently forces "Closes #<issue_number>" which assumes every PR closes
an issue; update the PR template to make this optional and flexible by replacing
or augmenting the "Closes #<issue_number>" line (the Related Issue section) with
an open prompt like "Related issue(s) or context (optional):" and include
guidance text such as "Optional: link to issue(s) or describe the problem being
solved if no issue exists" so contributors can either reference an issue or
describe the context.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In @.github/ISSUE_TEMPLATE/bug_report.md:
- Around line 27-29: The fenced code block containing the placeholder "Paste
error output here" is missing a language identifier; update the opening fence
(the triple backticks that start the block containing "Paste error output here")
to include a language token such as text (e.g., ```text) so the block renders
with proper syntax highlighting and formatting.

---

Nitpick comments:
In @.github/PULL_REQUEST_TEMPLATE.md:
- Around line 5-7: The "## Related Issue" section currently forces "Closes
#<issue_number>" which assumes every PR closes an issue; update the PR template
to make this optional and flexible by replacing or augmenting the "Closes
#<issue_number>" line (the Related Issue section) with an open prompt like
"Related issue(s) or context (optional):" and include guidance text such as
"Optional: link to issue(s) or describe the problem being solved if no issue
exists" so contributors can either reference an issue or describe the context.
🪄 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: defaults

Review profile: CHILL

Plan: Pro

Run ID: ca8b897d-59b8-4b39-8183-030eb002936e

📥 Commits

Reviewing files that changed from the base of the PR and between abeae92 and aeadb3a.

📒 Files selected for processing (4)
  • .github/ISSUE_TEMPLATE/bug_report.md
  • .github/ISSUE_TEMPLATE/feature_request.md
  • .github/PULL_REQUEST_TEMPLATE.md
  • CONTRIBUTING.md

Comment thread .github/ISSUE_TEMPLATE/bug_report.md Outdated
Claude and others added 2 commits April 5, 2026 09:24
- Add ruff format and mypy checks to PR template checklist
- Add debug output section to bug report template
- Add config.yml to disable blank issues

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
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.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In @.github/ISSUE_TEMPLATE/bug_report.md:
- Around line 42-44: The fenced code block containing "notebooklm -vv
<your-command-here>" is missing a language token which triggers MD040; update
that fence to include a shell/bash language identifier (e.g., add "bash" after
the opening ```), so the block becomes a bash code fence and resolves the MD040
warning while preserving the command text.
🪄 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: defaults

Review profile: CHILL

Plan: Pro

Run ID: 6562cc0b-24c2-43c3-9a13-e97a7d55e6a0

📥 Commits

Reviewing files that changed from the base of the PR and between 81d63a4 and 74ec98e.

📒 Files selected for processing (1)
  • .github/ISSUE_TEMPLATE/bug_report.md

Comment thread .github/ISSUE_TEMPLATE/bug_report.md Outdated
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@teng-lin teng-lin merged commit a997718 into main Apr 5, 2026
19 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.

Triage: identify and label bot-generated issues and PRs with inflated severity

1 participant