Skip to content

docs(git): adopt git-flow — develop integrates, main holds releases - #6

Closed
krlex wants to merge 1 commit into
developfrom
docs/git-flow
Closed

docs(git): adopt git-flow — develop integrates, main holds releases#6
krlex wants to merge 1 commit into
developfrom
docs/git-flow

Conversation

@krlex

@krlex krlex commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Every repo now has a permanent develop branch, so the guide has to say what the two branches are for. This PR targets develop, per the rule it introduces.

Contributing guide

  • Two long-lived branches, with a diagram: develop integrates all day-to-day work, main changes only when a release is cut.
  • Branch from develop, target develop in the PR. No PRs against main.
  • Release procedure: git merge --no-ff develop into main, tag on main, push both to the GitLab mirror.
  • Hotfixes: branch from main, merge back into main and into develop — otherwise the next release silently reverts the fix.
  • Branch hygiene: delete a feature branch on both remotes once its PR is merged.

CI/CD page

  • Release process now starts from a green develop, goes through an rc tag, then merge to main and tag there.
  • Tagging develop is acceptable only for a throwaway rc build.
  • The "a merge produces no image" callout now covers both branches.

Note on the previous PR

forail-devops#5, merged an hour ago, states "there is no devel branch in any Forail repo — branch from main". That was true when written and is now wrong; this supersedes it.

Every repo now has a permanent 'develop' branch alongside 'main', so the guide
has to say what they are for. Contributing guide:

- Two long-lived branches, with a diagram: work lands on develop, main changes
  only when a release is cut.
- Branch from develop and target develop in the PR; do not open PRs against
  main.
- Added the release procedure (merge --no-ff develop into main, tag on main,
  push both to the GitLab mirror) and hotfix handling -- a hotfix branched from
  main must be merged back into develop or the next release silently reverts it.
- Added branch hygiene: delete a feature branch on both remotes once merged.

CI/CD page:

- Release process starts from a green develop, goes through an rc tag, then
  merge to main and tag there. The tag is what publishes; tagging develop is
  only acceptable for a throwaway rc.
- The 'a merge to main produces no image' callout now covers both branches.
@krlex

krlex commented Jul 30, 2026

Copy link
Copy Markdown
Contributor Author

Zatvoreno — dokumentacija ne ide u repozitorijum; ostaje lokalno na hostu, a javno se objavljuje samo kroz GitHub Pages sajt.

@krlex krlex closed this Jul 30, 2026
@krlex
krlex deleted the docs/git-flow branch July 30, 2026 14:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant