Skip to content

docs: add contributing guidelines and github templates - #20

Closed
kavix wants to merge 3 commits into
clencyc:masterfrom
kavix:master
Closed

kavix wants to merge 3 commits into
clencyc:masterfrom
kavix:master

Conversation

@kavix

@kavix kavix commented Jun 9, 2026 •

Copy link
Copy Markdown

Add Contributing Guidelines and GitHub Templates

#13
Fixes #42

Summary

This PR introduces comprehensive contributor documentation and standardized GitHub templates to streamline onboarding, improve contribution quality, and establish consistent development workflows across the project.

Changes Made

1. Added CONTRIBUTING.md

Created a detailed contribution guide covering:

  • Development Environment Setup

    • Flask backend setup and configuration
    • React frontend installation and setup
    • Environment variable configuration
    • Database initialization steps
  • Testing Guidelines

    • Manual API testing procedures
    • Frontend verification in the browser
  • Code Style Standards

    • Python style guidelines (PEP 8)
    • TypeScript/React best practices
    • Functional component usage
    • Strict typing requirements
  • Git Workflow

    • Conventional Commit conventions (feat, fix, docs, etc.)
    • Branching strategy
    • Commit message standards
  • Pull Request Process

    • End-to-end contribution workflow
    • Code review expectations
    • Submission guidelines
  • Issue Reporting

    • Best practices for reporting bugs
    • Required information for actionable reports

2. Added GitHub Templates

Introduced standardized templates to improve issue and PR quality:

  • .github/ISSUE_TEMPLATE/bug_report.md

    • Structured bug reporting form
    • Reproduction steps
    • Environment details
    • Expected vs. actual behavior
  • .github/ISSUE_TEMPLATE/feature_request.md

    • Consistent format for proposing enhancements
    • Use case and benefit documentation
  • .github/pull_request_template.md

    • Contributor checklist
    • Testing verification
    • Review readiness requirements

3. Updated README.md

  • Added a direct link to the new CONTRIBUTING.md guide in the Contributing section.

Motivation

These additions lower the barrier to entry for new contributors, provide clear development standards, and help maintain code quality through a consistent contribution process. Standardized templates also reduce review friction by ensuring that issues and pull requests contain the necessary information from the start.

Checklist

  • Added CONTRIBUTING.md with setup, style, and contribution guidelines
  • Added bug report issue template
  • Added feature request issue template
  • Added pull request template
  • Updated README.md to link to the contribution guide

Summary by CodeRabbit

Summary by CodeRabbit

  • Documentation
    • Added standardized bug report and feature request templates for issue submissions
    • Added a pull request template to standardize PR descriptions, testing, and checklists
    • Rewrote the contributing guide with reorganized structure and clearer local setup/testing steps
    • Updated the README “Contributing” section to point to the dedicated contributing guide

@vercel

vercel Bot commented Jun 9, 2026

Copy link
Copy Markdown

@kavix is attempting to deploy a commit to the ClaraClency Team on Vercel.

A member of the Team first needs to authorize it.

@coderabbitai

coderabbitai Bot commented Jun 9, 2026 •

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

This PR adds standardized contribution templates and rewrites the contribution guide. Three new GitHub issue/PR templates define structured forms for bug reports, feature requests, and pull requests. The CONTRIBUTING.md guide is rewritten with explicit prerequisites, local development setup steps for backend and frontend, testing guidance, code style and commit conventions, and PR workflow. README.md is simplified to reference the new CONTRIBUTING.md.

Changes

Contribution Process Standardization

Layer / File(s) Summary
GitHub issue and pull request templates
.github/ISSUE_TEMPLATE/bug_report.md, .github/ISSUE_TEMPLATE/feature_request.md, .github/pull_request_template.md
Added YAML-structured templates for bug reports, feature requests, and PRs with required sections for issue details, reproduction steps, testing instructions, and completion checklists.
Development environment setup guide
CONTRIBUTING.md (lines 3–57)
Specified prerequisites (Node.js 18+, Python 3.10+, FFmpeg, Redis, PostgreSQL) and step-by-step local environment setup for backend and frontend, including virtualenv activation, environment file configuration, and database initialization.
Contribution workflows and code conventions
CONTRIBUTING.md (lines 59–96)
Defined code style requirements, Conventional Commits format with examples, PR process steps, and updated guidance for bug reporting and feature requests.
Documentation updates and closing message
CONTRIBUTING.md (lines 110–112), README.md (line 315)
Added closing thanks message to CONTRIBUTING.md and simplified README's Contributing section to reference the full CONTRIBUTING.md guide.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~15 minutes

Possibly related issues

  • clencyc/LiveEdit#13: This PR directly implements the requested CONTRIBUTING.md and GitHub templates (bug_report, feature_request, pull_request) for standardizing contributor workflows.

Possibly related PRs

  • clencyc/LiveEdit#18: Also updates CONTRIBUTING.md with contributor and development setup content.

Poem

🐰 A rabbit hops through templates neat,
Bug forms and feature requests so sweet,
Contributing guide, a developer's treat,
Setup steps and workflows complete,
Now contributions flow so neat! ✨

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The pull request title accurately summarizes the main changes: adding contributing guidelines and GitHub templates across CONTRIBUTING.md, issue templates, PR template, and README updates.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

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

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

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.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

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 current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.github/ISSUE_TEMPLATE/bug_report.md:
- Around line 26-29: Replace the incorrect "iOS" example in the "Desktop (please
complete the following information):" section with appropriate desktop OS
examples; update the Browser/Version lines if desired to keep examples coherent
(suggested replacements: "macOS", "Windows 10", or "Ubuntu 22.04") so the
Desktop example reflects actual desktop operating systems.
🪄 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: e6038e2a-a8e3-4cb2-bd59-ba1c708e3c55

📥 Commits

Reviewing files that changed from the base of the PR and between 248adfe and 4ad36b1.

📒 Files selected for processing (5)
  • .github/ISSUE_TEMPLATE/bug_report.md
  • .github/ISSUE_TEMPLATE/feature_request.md
  • .github/pull_request_template.md
  • CONTRIBUTING.md
  • README.md

Comment thread .github/ISSUE_TEMPLATE/bug_report.md
@netlify

netlify Bot commented Jun 9, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for livedit canceled.

Name Link
🔨 Latest commit 47188ff
🔍 Latest deploy log https://app.netlify.com/projects/livedit/deploys/6a2e8142989c3300085a7ed9

@kavix kavix left a comment

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Changed

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🧹 Nitpick comments (1)
README.md (1)

315-320: ⚡ Quick win

Keep the contribution instructions single-sourced.

These steps duplicate what CONTRIBUTING.md already covers, and the TESTING.md link is now easy to let drift. Either trim this section down to the new pointer or update it to reference CONTRIBUTING.md only. Please verify whether TESTING.md is still intended to be maintained.

♻️ Proposed fix
 ## 🤝 Contributing
 
 We welcome contributions! Please see our [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to get started, our code of conduct, and the process for submitting pull requests.
-1. Create a feature branch
-2. Make your changes
-3. Test locally (both frontend & backend)
-4. Submit PR with description
-5. See [TESTING.md](./TESTING.md) for the full testing guide.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@README.md` around lines 315 - 320, The contribution instructions in README.md
(the numbered steps 1-5 under the contribution section) are duplicating content
that already exists in CONTRIBUTING.md, creating a single-sourcing problem where
these instructions could drift apart. Remove the detailed numbered steps from
the README.md contribution section and instead keep only a brief reference
directing contributors to CONTRIBUTING.md as the authoritative source for
contribution guidelines. Additionally, verify that TESTING.md is still actively
maintained and up-to-date, since it is referenced in the proposed changes.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Nitpick comments:
In `@README.md`:
- Around line 315-320: The contribution instructions in README.md (the numbered
steps 1-5 under the contribution section) are duplicating content that already
exists in CONTRIBUTING.md, creating a single-sourcing problem where these
instructions could drift apart. Remove the detailed numbered steps from the
README.md contribution section and instead keep only a brief reference directing
contributors to CONTRIBUTING.md as the authoritative source for contribution
guidelines. Additionally, verify that TESTING.md is still actively maintained
and up-to-date, since it is referenced in the proposed changes.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 1d90d1f8-f575-4b80-96d1-da6fb802df4c

📥 Commits

Reviewing files that changed from the base of the PR and between 4ad36b1 and 47188ff.

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

@kavix

kavix commented Jun 14, 2026

Copy link
Copy Markdown
Author

Hi @clencyc , this PR is ready for review whenever you have a free moment. Thanks!

@kavix kavix closed this Jun 19, 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