Contributing

Sylius grows through community work.

You can contribute code, documentation, translations, reviews, and feedback. Each contribution improves the product for everyone.

What this section covers

This section helps you choose the right contribution path.

• Contributing Code covers changes to the product itself.
• Contributing Documentation covers improvements to guides, references, and examples.
• Contributing Translations covers language updates and localization work.
• Key Contributors highlights the people helping shape the project.

If you plan to contribute code, start here:

• Submitting a Patch explains how to prepare and send a change.
• Security Issues explains how to report vulnerabilities safely.
• Coding Standards defines the expected code style.
• Conventions describes shared implementation patterns.
• Sylius License and Trademark explains the legal boundaries for reuse and branding.

Principal rules

Follow a few core rules before you open a contribution:

• Keep changes focused. One problem, one clear fix.
• Respect existing standards, conventions, and release policies.
• Prefer small, reviewable improvements over broad rewrites.
• Report security issues privately. Do not disclose them publicly first.
• Make every change reproducible, testable, and easy to understand.

Spirit of open source

Open source is more than public code. It is shared ownership.

Contribute in a way that helps the next person build on your work. Write clearly. Explain intent. Leave context. Assume good faith during review.

Good open source work values maintainability over cleverness. It favors collaboration over ego. It treats feedback as part of the process, not a blocker to it.

The best contributions solve real problems, fit the project’s direction, and make life easier for users and maintainers.

Where to start

Pick the contribution type that matches your goal.

• Fix behavior or add a feature — start with Contributing Code.
• Improve clarity or accuracy — start with Contributing Documentation.
• Improve localization — start with Contributing Translations.