Introduction
Contributing
Below graph explains the process of contributing to Flow.
flowchart TD
subgraph "How to contribute"
is-a-bug[Did you found a bug?]
is-a-bug -->|Yes| can-you-fix-it[Can you fix it?]
is-a-bug -->|NO| is-a-question[Do you have a question?]
can-you-fix-it -->|NO| report[Please open a new **Bug Report**]
can-you-fix-it -->|YES| bug-fix[Please open a pull request with with a fixh]
is-a-question -->|YES| go-to-discord[Ask a **Community Question**]
is-a-question -->|NO| is-a-proposal[Do you want to propose new feature or a change?]
is-a-proposal -->|NO| looking-for-tasks[Are you looking for tasks?]
looking-for-tasks -->|YES| check-roadmap[Please check our Roadmap, there is always something to work on]
is-a-proposal -->|YES| open-a-proposal[Open a **Proposal**]
open-a-proposal --> wait-for-proposal-review["Give us time to review your proposal. We should get back to you in the first 24h (usually much faster)"]
wait-for-proposal-review --> is-proposal-approved[Was your proposal approved by core contributors?]
is-proposal-approved -->|YES| can-you-implement-it[Can you implement it?]
is-proposal-approved -->|NO| proposal-rejected[Consider implementing that proposal through existing extension points or **Fork this Project**]
can-you-implement-it -->|YES| submit-a-pr[Open a **Pull Request**]
can-you-implement-it -->|No| can-you-sponsor[Can you sponsor that proposal?]
can-you-sponsor -->|YES| sponsor-proposal[Awesome! Please mention that in the proposal description.]
can-you-sponsor -->|NO| wait-for-others[No worries, you will need to wait for someone to implement this one for you.]
end
How to?
- Submit a Bug Report
- Submit a Proposal
- Ask Community Question
- Sponsor Project of Proposal
- Project Roadmap
Project Roadmap
[!IMPORTANT] Flow PHP is managed through GitHub Projects. All code changes MUST first be added to the Roadmap.
Pull requests without an item in Roadmap might take significantly longer time to review or even get rejected due to missalignment with project architecture or future plans. In order to save time of contributors & maintainers, we would like to review the proposal before anyone starts to code.
The only exception from that rule are Bug Fixes - those can be opened without opening a proposal first. However it's still recommened to reach out as sometimes bugs might not be solvable imidiatelly or at all.
If the idea you are planning to work on is not yet in the Roadmap please create a new Proposal Issue and wait for further guidance.
Proposal is considered "Accepted" when added to the Roadmap by one of the Core Contributors. By default proposal are added to the upcoming milestone, whatevr can't be delivered during milestone due date is going to be moved to the next milestone.
Weeks of coding can save you hours of planning.
Opening a pull request without reaching out first might get rejected and eventually closed.
š Bug Fixes - bug fixes are the only exception from the above rule. Bug Fixes can be opened directly without
Before you start coding
Please make sure that you are aware of our Architecture Decision Records. It's mandatory to follow all of them without any exceptions unless explicitly overridden by a new ADR.
Next Steps
Adapters
Bridges
Contributors
Join us on GitHub
