# Contributing to FairMind

Welcome! We're excited that you're interested in contributing to FairMind. This guide will help you get started.

## Quick Start

1. **Find a Good First Issue**
   - Check our [Good First Issues](https://github.com/adhit-r/fairmind/wiki/Good-First-Issues) page
   - Look for issues labeled `good first issue`
   - Read the issue description carefully

2. **Set Up Your Environment**
   - See [Development Setup](https://github.com/adhit-r/fairmind/wiki/Development-Setup)
   - Clone the repository
   - Install dependencies
   - Run the development server

3. **Make Your Contribution**
   - Create a branch for your work
   - Make your changes
   - Write tests if applicable
   - Submit a pull request

## Finding Issues

### Good First Issues
Perfect for newcomers! These issues are:
- Well-documented
- Have clear acceptance criteria
- Include getting started instructions
- Low complexity, high impact

[View Good First Issues →](https://github.com/adhit-r/fairmind/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22)

### By Category
- **Frontend**: React/Next.js, UI/UX improvements
- **Backend**: API, database, services
- **AI/ML**: Model development, bias detection
- **Testing**: E2E tests, unit tests
- **Documentation**: Guides, tutorials

### By Milestone
- [Frontend Code Quality](https://github.com/adhit-r/fairmind/milestone/1) - Q1 2026
- [E2E Testing Suite](https://github.com/adhit-r/fairmind/milestone/2) - Q1 2026
- [Core Platform Features](https://github.com/adhit-r/fairmind/milestone/3) - Q2 2026
- [Platform Enhancements](https://github.com/adhit-r/fairmind/milestone/5) - Q2 2026
- [ML Infrastructure](https://github.com/adhit-r/fairmind/milestone/6) - Q3 2026
- [Compliance & Risk Management](https://github.com/adhit-r/fairmind/milestone/4) - Q4 2026

## Development Workflow

1. **Fork the Repository**
2. **Create a Branch**: `git checkout -b feature/your-feature-name`
3. **Make Changes**: Follow code style guidelines
4. **Test Your Changes**: Run tests and verify functionality
5. **Commit**: Write clear commit messages
6. **Push**: Push to your fork
7. **Pull Request**: Create a PR with description

## Code Style

- Follow existing code patterns
- Use TypeScript for type safety
- Write meaningful commit messages
- Add comments for complex logic
- Update documentation as needed

## Getting Help

- **Issues**: Ask questions in issue comments
- **Discussions**: Use GitHub Discussions for general questions
- **Documentation**: Check our docs folder

## Recognition

Contributors are recognized in:
- Repository contributors list
- Release notes
- Project documentation

Thank you for contributing to FairMind!