docs: add contributing guide and badges in README#12
docs: add contributing guide and badges in README#12RafaelPulzi wants to merge 1 commit intoOpenLake:mainfrom
Conversation
WalkthroughA new Changes
Estimated code review effortπ― 1 (Trivial) | β±οΈ ~3 minutes Poem
π₯ Pre-merge checks | β 5β Passed checks (5 passed)
βοΈ Tip: You can configure your own custom pre-merge checks in the settings. β¨ Finishing Touchesπ§ͺ Generate unit tests (beta)
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. Comment |
There was a problem hiding this comment.
π§Ή Nitpick comments (2)
CONTRIBUTING.md (1)
141-146: Pragmatic interim Code of Conduct guidance.The guide honestly acknowledges the absence of a dedicated Code of Conduct file while providing clear behavioral expectations. This is a reasonable approach.
If you'd like to add a formal Code of Conduct file, I can help generate one based on the Contributor Covenant or GitHub's community guidelines. Would you like me to open an issue to track this?
π€ Prompt for AI Agents
Verify each finding against the current code and only fix it if needed. In `@CONTRIBUTING.md` around lines 141 - 146, The CONTRIBUTING.md currently notes the absence of a project-specific Code of Conduct; to resolve this, add a dedicated CODE_OF_CONDUCT.md file (or a new section in CONTRIBUTING.md) containing a short, pragmatic Code of Conduct based on the Contributor Covenant or GitHub community guidelines, and update the "Code of Conduct" header in CONTRIBUTING.md to link to that new file; if you prefer, create a GitHub issue titled "Add project Code of Conduct" referencing the Contributor Covenant so we can approve and iterate on the canonical text.README.md (1)
4-6: Update the contributions badge link target.The contributions badge currently links to issue
#10, which will be closed once this PR is merged. Consider linking toCONTRIBUTING.mdinstead or to the general issues page to provide a more permanent and useful destination for potential contributors.π Proposed fix to link to CONTRIBUTING.md
- <a href="https://github.com/OpenLake/Homework-Scheduler/issues/10"> + <a href="./CONTRIBUTING.md"> <img alt="Contributions welcome" src="https://img.shields.io/badge/contributions-welcome-brightgreen.svg"> </a>Alternatively, link to the general issues page:
- <a href="https://github.com/OpenLake/Homework-Scheduler/issues/10"> + <a href="https://github.com/OpenLake/Homework-Scheduler/issues"> <img alt="Contributions welcome" src="https://img.shields.io/badge/contributions-welcome-brightgreen.svg"> </a>π€ Prompt for AI Agents
Verify each finding against the current code and only fix it if needed. In `@README.md` around lines 4 - 6, The contributions badge currently links to issue `#10`; update the anchor tag's href target (the <a href="..."> element wrapping the badge image) to a permanent destination such as "CONTRIBUTING.md" or the repository's general issues page (e.g., "/issues"), leaving the badge image (<img ...>) unchanged so the visual stays the same but the link points to a durable contribution guide.
π€ Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Nitpick comments:
In `@CONTRIBUTING.md`:
- Around line 141-146: The CONTRIBUTING.md currently notes the absence of a
project-specific Code of Conduct; to resolve this, add a dedicated
CODE_OF_CONDUCT.md file (or a new section in CONTRIBUTING.md) containing a
short, pragmatic Code of Conduct based on the Contributor Covenant or GitHub
community guidelines, and update the "Code of Conduct" header in CONTRIBUTING.md
to link to that new file; if you prefer, create a GitHub issue titled "Add
project Code of Conduct" referencing the Contributor Covenant so we can approve
and iterate on the canonical text.
In `@README.md`:
- Around line 4-6: The contributions badge currently links to issue `#10`; update
the anchor tag's href target (the <a href="..."> element wrapping the badge
image) to a permanent destination such as "CONTRIBUTING.md" or the repository's
general issues page (e.g., "/issues"), leaving the badge image (<img ...>)
unchanged so the visual stays the same but the link points to a durable
contribution guide.
βΉοΈ Review info
βοΈ Run configuration
Configuration used: Organization UI
Review profile: CHILL
Plan: Pro
Run ID: d3a0f317-f21a-4fec-9da9-0ec0d1b7e7b5
π Files selected for processing (2)
CONTRIBUTING.mdREADME.md
Closes #10
Summary
Adds a contributor guide tailored to Homework-Scheduler and a lightweight pull request template, following the repository's current setup and the OpenLake general template structure.
What changed
Why
The repository currently does not include contribution guidelines for new developers. This PR makes the onboarding process clearer by documenting local setup, linting/style expectations, Git workflow, pull request expectations, local validation, and bug reporting.
Notes for reviewers
Validation
Summary by CodeRabbit