Skip to content

Add CONTRIBUTING.md with guidelines for new contributors #169

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

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions