Skip to content

Add CONTRIBUTING.md with guidelines for new contributors #169

@Nimra-Fayaz

Description

@Nimra-Fayaz

Description

The project would benefit from a CONTRIBUTING.md file that guides new contributors on how to contribute effectively. This would help streamline the contribution process and make it easier for new contributors to get started.

Current State

  • Project accepts contributions (has issues labeled "good first issue")
  • But lacks clear contributing guidelines
  • New contributors may not know:
    • How to set up development environment
    • Code style guidelines
    • How to submit pull requests
    • Testing requirements
    • Commit message conventions
    • How to report bugs

Proposed Solution

Create CONTRIBUTING.md with:

  • Development setup instructions
  • Code style guide (PEP 8 for Python, etc.)
  • Pull request process and guidelines
  • Testing guidelines
  • How to report bugs
  • How to propose features
  • Commit message conventions

Benefits

  • Easier for new contributors to get started
  • More consistent contributions
  • Better code quality
  • Reduced maintainer workload answering questions
  • Clearer expectations for contributors

Additional Context

Having clear contributing guidelines is a best practice that helps both contributors and maintainers. It's especially helpful for projects with "good first issue" labels, as it provides a clear path for new contributors to follow.

Type

  • Bug report
  • Documentation improvement
  • Feature request
  • Code quality improvement

Checklist

  • I have searched existing issues to ensure this is not a duplicate
  • I have checked that CONTRIBUTING.md does not exist
  • I am willing to help implement this improvement if needed

Metadata

Metadata

Assignees

Labels

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions