Skip to content

feat: Update CONTRIBUTING.md to help first-time contributors.#567

Open
alexoneill wants to merge 4 commits intojniebuhr:masterfrom
alexoneill:docs
Open

feat: Update CONTRIBUTING.md to help first-time contributors.#567
alexoneill wants to merge 4 commits intojniebuhr:masterfrom
alexoneill:docs

Conversation

@alexoneill
Copy link

@alexoneill alexoneill commented Feb 1, 2026

Adds updated information about the CLA and commands to deploy firmware.

Summary by CodeRabbit

  • Documentation
    • Added CLA requirement and contact details for contributors
    • Expanded Getting Started with clearer steps, commands, and a deployment sequence
    • Added combined deployment reference table for Display, Controller, and Web UI
    • Clarified script/path notes and improved URL presentation in docs
    • Added migration-style command examples and broader PR guidance
    • Introduced issue-reporting section with repro steps and a markdown formatting tip

✏️ Tip: You can customize this high-level summary in your review settings.

Adds updated information about the CLA and commands to deploy firmware.
@cla-bot
Copy link

cla-bot bot commented Feb 1, 2026

We require contributors to sign our Contributor License Agreement, and we don't have yours on file. In order for us to review and merge your code, please contact @jniebuhr (mdwasp) on Discord to get yourself added.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Feb 1, 2026

Warning

Rate limit exceeded

@alexoneill has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 20 minutes and 1 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.

📝 Walkthrough

Walkthrough

Updates to CONTRIBUTING.md add a Contributor License Agreement requirement, expand and reformat Getting Started and deployment instructions (including a combined deployment table and example sequence), tighten script path formatting, add Prettier markdown tips, and add PR guidance and an issue reporting section.

Changes

Cohort / File(s) Summary
Documentation: CONTRIBUTING
CONTRIBUTING.md
Adds a CLA requirement and contact info; renames Controller Firmware references; refactors Getting Started with explicit build/upload steps, a combined deployment table and example sequence; formats script paths and dev/preview URLs; adds Prettier markdown tip, expanded PR guidance, and a Reporting Issues section.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐰 I hopped through lines of guidance bright,
CLA in paw and commands in sight,
Prettier trims the markdown fray,
Deployments clear — hop on your way! ✨

🚥 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 'Update CONTRIBUTING.md to help first-time contributors' directly and clearly summarizes the main change: improving the CONTRIBUTING.md documentation to better support new contributors.
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
  • Post copyable unit tests in a comment

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

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
CONTRIBUTING.md (1)

44-45: ⚠️ Potential issue | 🟡 Minor

Fix the likely typo in the library path.

lib/GaggiMateControlle looks misspelled and will confuse new contributors—should it be lib/GaggiMateController?

✅ Suggested fix
-Located in `lib/GaggiMateControlle` and `src/controller`.
+Located in `lib/GaggiMateController` and `src/controller`.
🤖 Fix all issues with AI agents
In `@CONTRIBUTING.md`:
- Around line 60-62: Update the three command description lines (`npm run dev`,
`npm run build`, `npm run preview`) to avoid bare URLs by wrapping them in angle
brackets or using markdown link syntax; for example, change
"http://localhost:5173/" and "http://localhost:4173/" to
`<http://localhost:5173/>` and `<http://localhost:4173/>` or
`http://localhost:5173/` as `[http://localhost:5173/](http://localhost:5173/)`
so markdownlint no longer flags bare URLs in those command entries.

@cla-bot
Copy link

cla-bot bot commented Feb 1, 2026

We require contributors to sign our Contributor License Agreement, and we don't have yours on file. In order for us to review and merge your code, please contact @jniebuhr (mdwasp) on Discord to get yourself added.

Copy link
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

🤖 Fix all issues with AI agents
In `@CONTRIBUTING.md`:
- Around line 7-9: Replace the wordy phrase "In order for us to review and merge
your code," in the CONTRIBUTING.md sentence with the tighter "To review and
merge your code," so the line reads: "To review and merge your code, please
contact `@jniebuhr` (mdwasp) on Discord to access the CLA." Ensure the rest of the
sentence and CLA reference remain unchanged.
🧹 Nitpick comments (1)
CONTRIBUTING.md (1)

90-95: Consider avoiding HTML <pre> inside the table for portability.

Some markdown renderers (including GitHub-flavored variants in other tooling) can be inconsistent with <pre> inside tables. A plain code block under the table or a compact multi-line command using <br> inside a normal table cell (without <pre>) tends to render more reliably.

@cla-bot
Copy link

cla-bot bot commented Feb 1, 2026

We require contributors to sign our Contributor License Agreement, and we don't have yours on file. In order for us to review and merge your code, please contact @jniebuhr (mdwasp) on Discord to get yourself added.

@cla-bot
Copy link

cla-bot bot commented Feb 1, 2026

We require contributors to sign our Contributor License Agreement, and we don't have yours on file. In order for us to review and merge your code, please contact @jniebuhr (mdwasp) on Discord to get yourself added.

@sonarqubecloud
Copy link

sonarqubecloud bot commented Feb 1, 2026

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