# Contributing to Neon-Style Thank you for your interest in contributing to our project! We appreciate your time and effort in making this project better. To ensure a smooth and effective collaboration, please follow these guidelines when contributing. ## Table of Contents - [Getting Started](#getting-started) - [Contributing Guidelines](#contributing-guidelines) - [Code Style and Conventions](#code-style-and-conventions) - [Issue Tracking](#issue-tracking) - [Communication](#communication) - [License](#license) ## Getting Started 1. Fork the repository to your own GitHub account. 2. Clone the forked repository to your local machine. 3. Install the necessary dependencies as outlined in the project's README file. 4. Create a new branch for your contribution: - Use a descriptive name that clearly represents the purpose of your changes. - Prefix the branch name with one of the following types: `feature/`, `bugfix/`, `hotfix/`, `docs/`, `refactor/`, or `test/`. 5. Make your changes or additions, following the project's coding style and guidelines. 6. Test your changes thoroughly to ensure they are functioning as expected. 7. Commit your changes with a clear and descriptive commit message. Follow the conventions described in the commit_convention.md file in docs. 8. Push your branch to your forked repository. 9. Submit a pull request (PR) to the original repository's `main` branch. - Include a detailed description of your changes, the problem you addressed, and any relevant information. - Reference any related issues using the appropriate GitHub issue syntax (e.g., "Fixes #123"). 10. Be prepared to address any feedback or requested changes during the review process. 11. Once your changes are approved, they will be merged into the main repository. ## Contributing Guidelines - Respect the project's code of conduct. Be kind, considerate, and inclusive in all interactions. - Follow the project's coding style and guidelines. Maintain consistent code formatting and adhere to best practices. - Ensure your contributions do not introduce breaking changes unless necessary and well-justified. - Document your code changes, new features, or any modifications to existing functionality. - Write tests for your code to ensure it functions correctly and does not introduce regressions. - If your contribution requires updating documentation, please make the necessary changes to the project's documentation files. ## Code Style and Conventions - Follow the coding style guidelines outlined in the project. This includes indentation, naming conventions, and other relevant conventions. - Keep your code clean, readable, and well-documented. Use clear and descriptive variable and function names. - Strive for modular and maintainable code. Break complex tasks into smaller, reusable functions or components. - Ensure your code follows the project's established patterns and architecture. ## Issue Tracking - Before starting work on a new feature or bug fix, check the project's issue tracker for any relevant issues. - If the issue doesn't exist, consider creating a new issue to discuss and get feedback on your proposed changes. - When working on an issue, mention the issue number in your commit messages and PR descriptions using the appropriate GitHub issue syntax (e.g., "Fixes #123"). ## Communication - Join the project's communication channels (e.g., Slack, Discord, mailing list) to engage with the community and get help if needed. - Feel free to ask questions, provide suggestions, or discuss your ideas before contributing. - Respect others' opinions and be open to constructive feedback and collaboration. ## License By contributing to this project, you agree to license your contributions under the [MIT](../LICENSE). Make sure you read the agreement.