Skip to content

docs: add 'Needs Help' page for new contributors#1355

Closed
sansyrox wants to merge 1 commit intomainfrom
docs/needs-help-page
Closed

docs: add 'Needs Help' page for new contributors#1355
sansyrox wants to merge 1 commit intomainfrom
docs/needs-help-page

Conversation

@sansyrox
Copy link
Copy Markdown
Member

@sansyrox sansyrox commented Mar 27, 2026

Summary

  • Adds a new "Needs Help" documentation page to guide new contributors
  • Links to GitHub issue filters for good first issues, help wanted, documentation, and bugs
  • Includes development setup instructions and contribution workflow
  • Links to community channels (Discord, GitHub Discussions, Twitter)
  • Adds navigation entry under Community Resources

Closes #833

Test plan

  • Verify the new page renders correctly at /documentation/en/needs-help
  • Verify navigation link appears in the sidebar under Community Resources
  • Verify all GitHub links resolve correctly

Made with Cursor

Summary by CodeRabbit

  • Documentation
    • Added a new "Needs Help" documentation page with curated contribution paths for different experience levels (Good First Issues, Help Wanted, etc.).
    • Included a getting started guide with development setup instructions and links to community resources (Discord, GitHub Discussions, Twitter/X).
    • Added navigation link to the page in English and Chinese.

@vercel
Copy link
Copy Markdown

vercel bot commented Mar 27, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
robyn Ready Ready Preview, Comment Mar 27, 2026 0:55am

@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Mar 27, 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: c1e70c59-7205-43b8-b909-24d6aebcce42

📥 Commits

Reviewing files that changed from the base of the PR and between 2587a16 and 96b28eb.

📒 Files selected for processing (2)
  • docs_src/src/components/documentation/Navigation.jsx
  • docs_src/src/pages/documentation/en/needs-help.mdx
✅ Files skipped from review due to trivial changes (1)
  • docs_src/src/pages/documentation/en/needs-help.mdx
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs_src/src/components/documentation/Navigation.jsx

📝 Walkthrough

Walkthrough

The PR adds a "Needs Help" documentation page with contribution guidelines, GitHub issue links by difficulty, development setup instructions, and community resources. The navigation component is updated with links to this new page, including translations for English and Chinese.

Changes

Cohort / File(s) Summary
Navigation Enhancement
docs_src/src/components/documentation/Navigation.jsx
Added new "Needs Help" navigation link with English and Chinese translations pointing to /documentation/en/needs-help.
Documentation Content
docs_src/src/pages/documentation/en/needs-help.mdx
Created new "Needs Help" documentation page containing contribution workflow, GitHub issue links organized by difficulty level (Good First Issues, Good Second Issues, Help Wanted, Documentation, Bug Fixes), development setup instructions including Rust and Python environment configuration, and external community resource links (Discord, GitHub Discussions, Twitter/X).

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐰 Hop along to seek some aid,
A helping path the docs have laid,
With links in English, Chinese too,
Come join us—there's much you can do!
Stack those carrots, pull requests grow,
In Robyn's garden, onwards we go! 🥕

🚥 Pre-merge checks | ✅ 3 | ❌ 2

❌ Failed checks (2 warnings)

Check name Status Explanation Resolution
Description check ⚠️ Warning The description provides a clear summary of changes but does not follow the required template structure with sections like 'Description', 'PR Checklist', and 'Pre-Commit Instructions'. Restructure the description to follow the provided template with proper sections including Description, Summary, PR Checklist, and Pre-Commit Instructions.
Linked Issues check ⚠️ Warning The PR addresses the core requirements from #833: creates a 'Needs Help' page with community links and contribution workflow. However, mention of Stack Overflow's Robyn tag appears to be missing. Add a reference to the Robyn tag on Stack Overflow as explicitly requested in issue #833 to fully address the linked issue requirements.
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and concisely summarizes the main change: adding a 'Needs Help' documentation page for new contributors.
Out of Scope Changes check ✅ Passed All changes are directly related to creating the 'Needs Help' documentation page and its navigation integration as specified in issue #833.
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 docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/needs-help-page

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

@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 `@docs_src/src/pages/documentation/en/needs-help.mdx`:
- Around line 45-49: Add a Stack Overflow entry to the Community list under the
"Community" heading: include a bullet like "Stack Overflow — Ask questions using
the robyn tag" and link it to the tag page
(https://stackoverflow.com/questions/tagged/robyn) so the Community section (the
list containing Discord, GitHub Discussions, and Twitter/X) mentions the Robyn
Stack Overflow tag as requested in Issue `#833`.
🪄 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: 9fa61447-ade1-4e59-b267-6c0962a7af0b

📥 Commits

Reviewing files that changed from the base of the PR and between 9e1fd74 and 2587a16.

📒 Files selected for processing (3)
  • docs_src/src/components/documentation/Navigation.jsx
  • docs_src/src/pages/documentation/en/needs-help.mdx
  • docs_src/src/pages/documentation/en/plugins.mdx

Comment on lines +45 to +49
## Community

- [Discord](https://discord.gg/rkERZ5eNU8) — Join our Discord server for discussions, questions, and real-time help
- [GitHub Discussions](https://github.com/sparckles/robyn/discussions) — For longer-form conversations and proposals
- [Twitter/X](https://twitter.com/robaborin) — Follow for updates and announcements
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Missing Stack Overflow mention per linked issue #833.

The PR objectives from Issue #833 explicitly state to "Mention the Robyn tag on Stack Overflow." The Community section currently lists Discord, GitHub Discussions, and Twitter/X, but is missing Stack Overflow.

📝 Suggested addition
 ## Community

 - [Discord](https://discord.gg/rkERZ5eNU8) — Join our Discord server for discussions, questions, and real-time help
 - [GitHub Discussions](https://github.com/sparckles/robyn/discussions) — For longer-form conversations and proposals
 - [Twitter/X](https://twitter.com/robaborin) — Follow for updates and announcements
+- [Stack Overflow](https://stackoverflow.com/questions/tagged/robyn) — Ask questions using the `robyn` tag
📝 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
## Community
- [Discord](https://discord.gg/rkERZ5eNU8) — Join our Discord server for discussions, questions, and real-time help
- [GitHub Discussions](https://github.com/sparckles/robyn/discussions) — For longer-form conversations and proposals
- [Twitter/X](https://twitter.com/robaborin) — Follow for updates and announcements
## Community
- [Discord](https://discord.gg/rkERZ5eNU8) — Join our Discord server for discussions, questions, and real-time help
- [GitHub Discussions](https://github.com/sparckles/robyn/discussions) — For longer-form conversations and proposals
- [Twitter/X](https://twitter.com/robaborin) — Follow for updates and announcements
- [Stack Overflow](https://stackoverflow.com/questions/tagged/robyn) — Ask questions using the `robyn` tag
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs_src/src/pages/documentation/en/needs-help.mdx` around lines 45 - 49, Add
a Stack Overflow entry to the Community list under the "Community" heading:
include a bullet like "Stack Overflow — Ask questions using the robyn tag" and
link it to the tag page (https://stackoverflow.com/questions/tagged/robyn) so
the Community section (the list containing Discord, GitHub Discussions, and
Twitter/X) mentions the Robyn Stack Overflow tag as requested in Issue `#833`.

@codspeed-hq
Copy link
Copy Markdown

codspeed-hq bot commented Mar 27, 2026

Merging this PR will not alter performance

✅ 189 untouched benchmarks


Comparing docs/needs-help-page (96b28eb) with main (9e1fd74)

Open in CodSpeed

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.

add a needs help page in the docs

1 participant