Contribute to Soplang

Soplang is an open-source project that thrives on community contributions. There are many ways to contribute, regardless of your skill level or background.

Why Contribute?

Improve Your Skills

Contributing to Soplang is a great way to improve your programming skills and learn from experienced developers.

Join the Community

Become part of a vibrant community of developers passionate about creating a better programming language.

Make an Impact

Your contributions can help thousands of developers who use Soplang around the world.

Ways to Contribute

Code Contributions

Help improve Soplang by contributing code to the core language, standard library, or tools.

Learn more →

Documentation

Help improve the documentation by fixing errors, adding examples, or writing tutorials.

Learn more →

Bug Reports

Report bugs or suggest improvements to help make Soplang more stable and feature-rich.

Learn more →

Translations

Help translate Soplang documentation and resources into different languages.

Learn more →

Community Support

Help other users by answering questions in forums, chat, or mailing lists.

Learn more →

Financial Support

Donate to the Soplang project to help fund development and infrastructure.

Learn more →

Getting Started

1. Set Up Your Development Environment

Before you can contribute to Soplang, you'll need to set up your development environment:

# Clone the repository
git clone https://github.com/soplang/soplang.git
cd soplang

# Install dependencies
pip install -r requirements-dev.txt

# Run tests to make sure everything is working
python -m pytest

For more detailed instructions, see the Development Setup Guide.

2. Find an Issue to Work On

We maintain a list of beginner-friendly issues that are good starting points for new contributors:

  • Look for issues labeled good first issue or help wanted
  • Check the project roadmap for upcoming features
  • Browse the forums for user-requested features
Browse Issues on GitHub

3. Submit Your Contribution

Once you've made your changes, submit a pull request:

  1. Create a new branch for your changes
  2. Make your changes and commit them with clear, descriptive commit messages
  3. Push your branch to your fork
  4. Open a pull request against the main Soplang repository
  5. Wait for feedback from maintainers

Contribution Guidelines

Code Style

We follow PEP 8 with some modifications. Please ensure your code adheres to our style guide. Use the provided linters and formatters to check your code before submitting.

Testing

All code contributions should include appropriate tests. We use pytest for our test suite. Make sure all tests pass before submitting your pull request.

Documentation

Code should be well-documented with docstrings and comments where appropriate. If you're adding a new feature, please also update the relevant documentation.

Pull Requests

Keep pull requests focused on a single change. If you have multiple changes to make, submit multiple pull requests. Provide a clear description of the problem and solution.

Top Contributors

M

Mr Sharafdin

Core Developer

247 contributions

O

Omar Tood

Documentation Lead

183 contributions

I

Ismail Ainte

Community Manager

156 contributions

Need Help Getting Started?

If you have questions about contributing to Soplang, don't hesitate to reach out to us. We're always happy to help new contributors get started.