This is a follow-up to forgejo/forgejo#409
Given the nature as soft-fork of Gitea there are a handful of branches we have to juggle for our releases. This can feel intimidating (happened to at least two members of the organisation).
forgejo/forgejo@613c87ed70/CONTRIBUTING/WORKFLOW.md
Since we have support for Mermaid, I propose to add a flowchart (see https://mermaid.js.org/syntax/examples.html#basic-flowchart ) to aid in the decision making.
What I need is an answer to questions like:
I want to contribute an accessibility fix. Which branch do I have to branch of of? What should be the target branch when I open a Pull Request?
And
In which relationship are the branches to each other?
(Like, branch X is branched of of Y and will be merged back after rebase of Y on top of Z).
Having it visualised could help. Mermaid is text-based so updating should also be low-effort.
Note, that this must not replace a text representation. See https://adrianroselli.com/2022/03/maybe-dont-use-flow-charts-on-github.html and https://mermaid.js.org/config/accessibility.html
CC @fsologureng
This is a follow-up to https://codeberg.org/forgejo/forgejo/pulls/409
Given the nature as soft-fork of Gitea there are a handful of branches we have to juggle for our releases. This can feel intimidating (happened to at least two members of the organisation).
https://codeberg.org/forgejo/forgejo/src/commit/613c87ed7082e65f3b68a01def46268dd671d539/CONTRIBUTING/WORKFLOW.md
Since we have support for Mermaid, I propose to add a flowchart (see https://mermaid.js.org/syntax/examples.html#basic-flowchart ) to aid in the decision making.
What I need is an answer to questions like:
> I want to contribute an accessibility fix. Which branch do I have to branch of of? What should be the target branch when I open a Pull Request?
And
> In which relationship are the branches to each other?
(Like, branch X is branched of of Y and will be merged back after rebase of Y on top of Z).
Having it visualised could help. Mermaid is text-based so updating should also be low-effort.
Note, that this must not replace a text representation. See https://adrianroselli.com/2022/03/maybe-dont-use-flow-charts-on-github.html and https://mermaid.js.org/config/accessibility.html
CC @fsologureng