# Contributing to FIFA Player Recommendation System

Thank you for your interest in contributing! This document provides guidelines for contributing to the project.

## 🚀 Getting Started

1. **Fork the repository**
2. **Clone your fork**
   ```bash
   git clone https://github.com/YOUR_USERNAME/FIFA-Player-Recomendation.git
   cd FIFA-Player-Recomendation
   ```
3. **Create a branch**
   ```bash
   git checkout -b feature/your-feature-name
   ```

## 💻 Development Setup

1. **Install dependencies**
   ```bash
   pip install -r requirements.txt
   ```

2. **Train models**
   ```bash
   python training/train.py
   ```

3. **Run the app**
   ```bash
   python run.py
   ```

## 📝 Coding Standards

### Python
- Follow PEP 8 style guide
- Use type hints where applicable
- Add docstrings to all functions/classes
- Keep functions focused and small
- Use meaningful variable names

### JavaScript
- Use ES6+ features
- Use camelCase for variables/functions
- Add comments for complex logic
- Keep functions pure when possible

### CSS
- Use BEM naming convention
- Group related properties
- Use CSS variables for colors
- Mobile-first responsive design

## 🧪 Testing

Before submitting:
1. Test all API endpoints
2. Verify UI on different screen sizes
3. Check console for errors
4. Test with both male and female datasets

## 📬 Submitting Changes

1. **Commit your changes**
   ```bash
   git add .
   git commit -m "Add: Brief description of changes"
   ```

2. **Push to your fork**
   ```bash
   git push origin feature/your-feature-name
   ```

3. **Create a Pull Request**
   - Provide clear description
   - Reference any related issues
   - Add screenshots if UI changes

## 🐛 Reporting Bugs

Use GitHub Issues and include:
- Description of the bug
- Steps to reproduce
- Expected vs actual behavior
- Screenshots (if applicable)
- Environment details (OS, Python version, etc.)

## 💡 Feature Requests

Open a GitHub Issue with:
- Clear feature description
- Use case/motivation
- Proposed implementation (optional)

## 📋 Areas for Contribution

- **Algorithm improvements** - Better recommendation algorithms
- **UI enhancements** - Design improvements, animations
- **New features** - Squad builder, career mode tracking
- **Performance** - Optimization, caching
- **Documentation** - Tutorials, examples, translations
- **Testing** - Unit tests, integration tests

## ✅ Pull Request Checklist

- [ ] Code follows project style guidelines
- [ ] Comments added for complex logic
- [ ] Documentation updated (if needed)
- [ ] Tested locally
- [ ] No console errors
- [ ] Responsive design maintained
- [ ] Works with both datasets

## 🤝 Code of Conduct

- Be respectful and inclusive
- Welcome newcomers
- Focus on constructive feedback
- Maintain professionalism

## 📞 Questions?

- Open a GitHub Issue
- Contact: [@inboxpraveen](https://github.com/inboxpraveen)

Thank you for contributing! 🎉