Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Contributing guide #114

Merged
merged 4 commits into from
May 6, 2024
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
66 changes: 66 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
# Contributing Guide for SalamLang/Salam

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.

## Ways to Contribute

1. **Code Contributions**: Fix bugs, add new features, or improve existing code. Follow our coding conventions and guidelines (see below) when submitting code contributions.

2. **Documentation**: Write or improve documentation, including README files, code comments, and user guides, to help others understand and use Salam.

3. **Testing**: Ensure the quality and stability of Salam by writing and running tests, identifying bugs, and preventing regressions.

4. **Bug Reports**: Report any bugs or unexpected behavior you encounter, including steps to reproduce the issue and your environment details.

5. **Feature Requests**: Share your ideas for new features or improvements and discuss them with the community and project maintainers.

6. **Community Support**: Help others by answering questions, providing support, and sharing your expertise on our mailing list, forums, or chat channels.

## Getting Started

1. **Fork the Repository**: Create your own copy of the project by forking the SalamLang/Salam repository on GitHub.

2. **Clone Your Fork**: Clone the repository to your local machine using

```
git clone https://github.com/your-username/Salam.git
```

3. **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
```

4. **Make Changes**: Make your changes to the code, documentation, or tests as needed.

5. **Test Your Changes**: Thoroughly test your changes to ensure they work as expected.

6. **Commit Your Changes**: Commit your changes to your branch with a clear and descriptive commit message.

```
git commit -am 'Add my new feature'
```

7. **Push Your Changes**: Push your changes to your fork on GitHub.

```
git push origin feature/my-new-feature
```

8. **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.

## Code Style and Guidelines

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.

## Feedback and Support

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.
jbampton marked this conversation as resolved.
Show resolved Hide resolved

Thank you for your interest in contributing to Salam! We appreciate your help in making this project a success. Happy coding!
5 changes: 5 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,8 +22,13 @@ Example:

Feel free to explore and create using Salam!
For more information, visit: https://salamlang.ir

jbampton marked this conversation as resolved.
Show resolved Hide resolved
```

## Contributing

Want to contribute to Salam? Check out our [Contributing Guide](CONTRIBUTING.md) for more information.

## Salam Contributors

- [Max Base](https://github.com/BaseMax)
Expand Down