Skip to content

999 contributors guide for new features#1005

Open
SZeltaat wants to merge 3 commits intomainfrom
999-contributors-guide-for-new-features
Open

999 contributors guide for new features#1005
SZeltaat wants to merge 3 commits intomainfrom
999-contributors-guide-for-new-features

Conversation

@SZeltaat
Copy link
Contributor

@SZeltaat SZeltaat commented Mar 25, 2026

Description

Hi there,

This is the contribution guide for introducing new features. Please let me know if you agree on its content. And if you have suggestions to improve it.

Here's the preview

Fixes #999

It also contains a small fix on the cli guideline. Don't worry about it 😉

Type of change

  • Documentation

Checklist:

  • I have made corresponding changes to the documentation

Summary by CodeRabbit

  • Documentation

    • Added comprehensive new feature proposal guidelines for contributors, including workflow and approval criteria.
    • Updated CLI documentation to dynamically display current help output instead of static text.
  • Chores

    • Extended build artifact exclusions to ignore documentation generation files.

@SZeltaat SZeltaat self-assigned this Mar 25, 2026
@SZeltaat SZeltaat linked an issue Mar 25, 2026 that may be closed by this pull request
@github-actions
Copy link

Thank you so much for contributing to Blueprints!
Your contributions help thousands of engineers work more efficiently and accurately.

Now that you've created your pull request, please don't go away; take a look at the bottom of this page for the automated checks that should already be running. If they pass, great! If not, please click on 'Details' and see if you can fix the problem they've identified. A maintainer should be along shortly to review your pull request and help get it added!

@coderabbitai
Copy link

coderabbitai bot commented Mar 25, 2026

📝 Walkthrough

Walkthrough

Extended .gitignore to exclude documentation build artifacts, updated CLI documentation with dynamic help output, added feature proposal workflow documentation, and linked the new contributor guide to the main contribution index page.

Changes

Cohort / File(s) Summary
Build Configuration
.gitignore
Added exclusions for documentation build artifacts including full_design_report.tex, localized report_*.tex files (de, en, es, fr, nl), and generated outputs (report.tex, report.docx, report_nl.docx).
Contribution Documentation
docs/guides/contribute/index.md, docs/guides/contribute/cli.md, docs/guides/contribute/new-feature.md
Updated CLI documentation with executable Python snippet that dynamically runs and captures blueprints --help output with constrained terminal width. Added new feature proposal workflow guide covering criteria, approval process, core team roster, and implementation requirements. Linked new feature guideline from main contribution index.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

Poem

🐰 ✨ The docs now hop with clearer paths,
From gitignore to guides and graphs,
Features proposed with wisdom's light,
Contributors dance through CLI's sight! 📚🌟

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately reflects the main objective of adding a contributors guide for new features as evidenced by the new documentation file and linked issue #999.
Linked Issues check ✅ Passed The PR fulfills the objective of issue #999 by adding a comprehensive new-feature contribution guide with proposal workflow, consensus requirements, team definitions, and implementation strategy.
Out of Scope Changes check ✅ Passed Changes are primarily in-scope: the new-feature.md guide directly addresses issue #999, documentation updates to index.md support navigation, and the cli.md change modernizes help text generation, all within documentation scope.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description check ✅ Passed The pull request description follows the required template structure with Description, Type of change, and Checklist sections. All required elements are present.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch 999-contributors-guide-for-new-features

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.

@codecov
Copy link

codecov bot commented Mar 25, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (bd184d4) to head (8cb6999).

Additional details and impacted files
@@            Coverage Diff            @@
##              main     #1005   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files          441       441           
  Lines        13673     13673           
=========================================
  Hits         13673     13673           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

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

🤖 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/guides/contribute/cli.md`:
- Around line 32-40: The docs example calling subprocess.run to execute the CLI
help is currently ignoring failures; update the call to subprocess.run (the
invocation that runs ["blueprints", "--help"]) to pass check=True so that
subprocess.CalledProcessError is raised on non-zero exit and the docs build
fails fast; keep the rest of the invocation (capture_output, text, env)
unchanged and ensure the result variable (result) is still used to print
result.stdout.

In `@docs/guides/contribute/new-feature.md`:
- Line 94: Replace the incorrect contributor line "Sina Zel taat
([`@SZeltaat`](https://github.com/SZeltaat))" with the correctly formatted name
that matches the GitHub handle; update it to "Sina Zeltaat
([`@SZeltaat`](https://github.com/SZeltaat))" so the display name and spacing are
consistent with the handle.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 3ebb3c0c-a8a6-484c-afc1-f2e949fc9f67

📥 Commits

Reviewing files that changed from the base of the PR and between bd184d4 and 2a50e86.

📒 Files selected for processing (4)
  • .gitignore
  • docs/guides/contribute/cli.md
  • docs/guides/contribute/index.md
  • docs/guides/contribute/new-feature.md

Comment on lines +32 to +40
```python exec="on" result="ansi"
import subprocess, os
result = subprocess.run(
["blueprints", "--help"],
capture_output=True,
text=True,
env={**os.environ, "COLUMNS": "80", "FORCE_COLOR": "1"},
)
print(result.stdout)
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

Fail fast when blueprints --help execution fails.

The snippet currently ignores command failures; docs can render with missing/empty help output. Add check=True so docs build fails loudly when CLI help cannot be generated.

Suggested patch
-    import subprocess, os
+    import os
+    import subprocess
     result = subprocess.run(
         ["blueprints", "--help"],
         capture_output=True,
         text=True,
+        check=True,
         env={**os.environ, "COLUMNS": "80", "FORCE_COLOR": "1"},
     )
     print(result.stdout)
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/guides/contribute/cli.md` around lines 32 - 40, The docs example calling
subprocess.run to execute the CLI help is currently ignoring failures; update
the call to subprocess.run (the invocation that runs ["blueprints", "--help"])
to pass check=True so that subprocess.CalledProcessError is raised on non-zero
exit and the docs build fails fast; keep the rest of the invocation
(capture_output, text, env) unchanged and ensure the result variable (result) is
still used to print result.stdout.

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.

Contributors guide for new features

1 participant