Welcome to Salam! We're excited to have you on board and contributing to our open-source project. This guide will help you navigate the contribution process and ensure that your contributions are valuable and well-received.
-
Code Contributions: Fix bugs, add new features, or improve existing code. Follow our coding conventions and guidelines (see below) when submitting code contributions.
-
Documentation: Write or improve documentation, including README files, code comments, and user guides, to help others understand and use Salam.
-
Testing: Ensure the quality and stability of Salam by writing and running tests, identifying bugs, and preventing regressions.
-
Bug Reports: Report any bugs or unexpected behavior you encounter, including steps to reproduce the issue and your environment details.
-
Feature Requests: Share your ideas for new features or improvements and discuss them with the community and project maintainers.
-
Community Support: Help others by answering questions, providing support, and sharing your expertise on our mailing list, forums, or chat channels.
-
Fork the Repository: Create your own copy of the project by forking the SalamLang/Salam repository on GitHub.
-
Clone Your Fork: Clone the repository to your local machine using
git clone https://github.com/your-username/Salam.git
-
Create a Branch: Create a new branch for your contribution using a descriptive name, such as feature/my-new-feature.
git checkout -b feature/my-new-feature
-
Make Changes: Make your changes to the code, documentation, or tests as needed.
-
Test Your Changes: Thoroughly test your changes to ensure they work as expected.
-
Commit Your Changes: Commit your changes to your branch with a clear and descriptive commit message.
git commit -am 'Add my new feature'
-
Push Your Changes: Push your changes to your fork on GitHub.
git push origin feature/my-new-feature
-
Submit a Pull Request: Submit a pull request from your branch to the main repository, providing a clear description of your changes and why they're valuable.
To maintain consistency and readability, please follow these coding conventions and guidelines when contributing code:
- Write clear and descriptive variable names, function names, and comments.
- Use meaningful commit messages that describe the purpose of each commit.
- Keep code changes focused and atomic. Avoid making unrelated changes in the same pull request.
- Test your code thoroughly to ensure it functions correctly and doesn't introduce regressions.
If you have any questions, feedback, or need support, don't hesitate to reach out to the project maintainers or the community. We're here to help and support each other in making Salam the best it can be.
Thank you for your interest in contributing to Salam! We appreciate your help in making this project a success. Happy coding!