
## Table of Contents

1. [Introduction](#introduction)
2. [The Main Branch: Squash and Merge](#the-main-branch-squash-and-merge)
3. [Other Benefits](#other-benefits)
4. [Other Cases for Main](#other-cases-for-main)
5. [Example: Create Feature Branch](#example-create-feature-branch)
6. [The Release Branch: Fast-Forward](#the-release-branch-fast-forward)
7. [Syntax: Syncing Main to Release](#syntax-syncing-main-to-release)
8. [Conclusion](#conclusion)

## Introduction

This blog demonstrates a clean and efficient Git workflow tailored for small teams. We will focus on keeping the `main` branch history readable while ensuring the `release` branch remains a stable mirror of production.

## The Main Branch: Squash and Merge

When working on features or bugs, developers often create dozens of "work-in-progress" commits. To keep the `main` branch clean, we use the **Squash and Merge** pattern. This collapses all commits from a branch into a single, high-quality commit on `main`.

- **Feature Branches (`feature/description`):** Use this for new development.
- **Bug Branches (`bugs/description`):** Use this for fixing issues found in development.

## Other Benefits

- **Feature Reversion:** If a feature introduced a failure, squashing makes it easier to revert the change.
- **Simplified "Git Blame":** `git blame` will point to a feature instead of an individual commit like `fixed typo`.
- **Avoiding "Broken" Intermediate Commits:** Sometimes in a feature branch a developer fixes the build or unit tests. If you don't use squash and keep all history, the main branch will contain "broken" build commits.

## Other Cases for Main

Beyond features and bugs, you might merge into `main` for:

- **Refactoring:** Code cleanup that doesn't change functionality.
- **Documentation:** Updates to README files or API docs.
- **CI/CD Updates:** Modifying GitHub Actions or deployment scripts.
- **Dependency Updates:** Merging automated PRs (like Dependabot) to keep libraries secure.

## Example: Create Feature Branch

```
# Ensure you are on main and up to date
git checkout main
git pull origin main

# Create and switch to a new feature branch
git checkout -b feature/describe-feature
```

## The Release Branch: Fast-Forward

For small teams, we want the `release` branch to be easy to manage. We use the **Fast-Forward** pattern, which keeps all commit history identical between `main` and `release`.

**Alternative Approaches:**

- **Merge Commits:** Some teams use `--no-ff` to create a dedicated "Merge node" to show exactly when a release happened.
- **Squash to Release:** Some teams squash all of `main` into one single "Version 1.0" commit on the release branch, though this makes tracking individual changes harder.

## Syntax: Syncing Main to Release

To move your verified code from `main` to `release` using the fast-forward pattern, run:

```bash
git checkout release
git merge main --ff-only
git push origin release
```

## Conclusion

By using Squash for development and Fast-Forward for releases, your team maintains a professional, readable history that is easy to debug. Hopefully, you find this pattern helpful for your team's workflow!


A practical guide on using Squash and Fast-Forward patterns to manage a clean Git workflow.

Workflow

Git Merge Patterns for Main and Release Branches