Ways to Contribute

Code

Contribute to the compiler, runtime, standard library, or tooling. From bug fixes to new features, all contributions are welcome.

View on GitHub

Documentation

Help improve tutorials, write examples, fix typos, or translate documentation. Good docs make the language accessible to everyone.

Documentation repo

Community

Answer questions, help newcomers, share your projects, and participate in discussions. A welcoming community is essential.

Join Discussions

Testing

Try Simplex on real projects, report bugs, suggest improvements, and help ensure the language works well in practice.

Report issues

Community Spaces

Platform Purpose Link
GitHub Discussions Community discussions, Q&A, RFCs, and design proposals Participate
GitHub Issues Bug reports, feature requests, and task tracking View issues
GitHub Repository Source code, pull requests, and releases View repo

Your First Contribution

New to open source or to Simplex? Here's how to get started:

  1. Set up your environment: Follow the development setup guide to build Simplex locally.
  2. Find a good first issue: Look for issues labeled "good first issue" - these are specifically chosen for newcomers.
  3. Ask questions: If you're stuck, open a discussion on GitHub or comment on the issue. We're happy to help!
  4. Submit a pull request: Once you've made changes, submit a PR. We'll review it and provide feedback.

No Contribution Too Small

Fixing a typo in documentation, improving an error message, or adding a test case - every contribution matters. Don't hesitate to submit small improvements.

Contribution Areas

Language & Compiler

  • Parser improvements and error messages
  • Type system enhancements
  • Bytecode optimization
  • New language features (via RFC process)

Runtime & VM

  • Actor scheduler improvements
  • Checkpoint and recovery
  • Memory management
  • JIT compilation

Swarm & Distribution

  • Cluster coordination
  • Actor placement strategies
  • Network protocols
  • Cloud integrations (AWS, GCP, Azure)

AI Integration

  • Model loading and inference
  • Batching and optimization
  • New AI primitives
  • Specialist fine-tuning tools

Tooling

  • IDE/editor plugins (VS Code, Vim, Emacs)
  • Formatter and linter
  • Debugger
  • Package manager

Documentation

  • Tutorials and guides
  • API documentation
  • Examples and cookbook
  • Translations

Code of Conduct

The Simplex community is committed to providing a welcoming and inclusive environment for everyone. We expect all participants to:

  • Be respectful and considerate
  • Be welcoming to newcomers
  • Accept constructive criticism gracefully
  • Focus on what's best for the community
  • Show empathy towards others

Harassment, discrimination, and exclusionary behavior are not tolerated. See our full Code of Conduct for details.

Governance

Simplex uses a benevolent dictator model with community input:

  • Core Team: Makes final decisions on language direction
  • RFC Process: Major changes go through public proposal and discussion
  • Working Groups: Focused teams for specific areas (runtime, AI, tooling)

As the project grows, governance may evolve to include more community representation.

Recognition

We believe in recognizing contributions:

  • Contributors page: All contributors are listed on our website
  • Release notes: Contributors are credited in release announcements
  • Swag: Active contributors receive Simplex merchandise
  • Core team: Consistent contributors may be invited to join the core team

Ready to Start?