contact@sabrineferchichi.fr
100%
🇺🇸 EN
  • 🇺🇸 English
  • 🇫🇷 Français
SF Sabrine F. Portfolio
Contact
  • Portfolio
  • Blog
  • About
Contact
SF Sabrine F. Portfolio
  • About
  • Portfolio
  • Blog
  • Contact
Languages
🇺🇸 English 🇫🇷 Français
Accessibility
100%

Clean Git: Naming Conventions and History Mastery

  1. Home
  2. Blog
  3. Clean Git: Naming Conventions and History Mastery
Clean Git: Naming Conventions and History Mastery

In a professional environment, Git is not just a backup tool; it is your project's logbook. A clean history and well-named branches are the foundations of efficient code review and stress-free deployment.

1. Branch Naming Strategy

A branch name should allow any team member to identify the type of work and the associated ticket without opening Jira or Redmine.

Recommended Conventions (Prefix/ID-Description)

  • feature/: New feature development (e.g., feature/123-api-auth).
  • fix/: Bug fix (e.g., fix/456-cart-total-tax).
  • hotfix/: Urgent production fix (e.g., hotfix/789-security-patch).
  • refactor/: Code improvement without functional changes.

2. Clean History: Rebase vs. Merge

For a Lead Developer, history clarity is paramount. Two philosophies clash:

  • Rebase (Recommended): By using git rebase main on your feature branch, you rewrite your commits on top of the latest commit of the main branch. This creates a linear history, easy to read and debug.
  • Merge: Creates a "merge commit" that mixes timelines. Avoid this on feature branches to prevent polluting the history with "Merge branch..." messages.

3. The Art of Atomic Commits

A good commit should address a single intent. If you fix a bug AND reformat code, make two commits.

Professional Message Structure

[#TICKET_ID] type(scope): subject

- Detailed description of changes
- Why this change was necessary

4. Advanced Techniques: Squash and Tags

Before merging a Pull Request, use Interactive Rebase (git rebase -i) to "squash" your minor work commits (e.g., "fix typo", "wip") into a single clean, meaningful commit.

Finally, use Tags to mark your deployments (e.g., v1.2.0). This allows for quick rollbacks and perfect traceability of versions released to production.

By adopting these standards, you reduce the team's cognitive load during code reviews and greatly facilitate continuous integration.

  • No comments
  • No likes
Prev

Best Practices for Developer-Friendly Documentation

Next

Sylius Modularity: Building Scalable E-commerce Architectures

Sabrine FERCHICHI

Sabrine FERCHICHI

Lead Developer, Sylius expert and certified Agile Scrum Developer. Specialized in designing robust e-commerce architectures, I share my technical monitoring and feedback here, primarily focused on the Sylius and Symfony ecosystem.

No comments

Leave a comment

Latest articles

Sylius V2 - Payment Simpl...

Sylius V2 - Payment Simplification and "...

25 Dec 2025

Sylius V2 - New Bootstrap...

Sylius V2 - New Bootstrap-based Admin UI...

18 Dec 2025

Sylius V2 - Template Cust...

Sylius V2 - Template Customization with ...

11 Dec 2025

Sylius V2 - Improvements ...

Sylius V2 - Improvements with PHP 8 Attr...

07 Dec 2025

Sylius V2 - Symfony Workf...

Sylius V2 - Symfony Workflow Alternative...

06 Dec 2025

Sylius V2 - Symfony 7 Com...

Sylius V2 - Symfony 7 Compatibility

05 Dec 2025

Tags

Meetup Agile API Artificial Intelligence Best Practices Code Quality Documentation E-commerce Ecosystem GDPR Git Performance Plugin Security Sylius Sylius V2 SyliusCon Symfony Testing Tools UX Web Development

Newsletter

Filters & Search

Latest articles

Sylius V2 - Payment Simpl...

Sylius V2 - Payment Simplification and "...

25 Dec 2025

Sylius V2 - New Bootstrap...

Sylius V2 - New Bootstrap-based Admin UI...

18 Dec 2025

Sylius V2 - Template Cust...

Sylius V2 - Template Customization with ...

11 Dec 2025

Sylius V2 - Improvements ...

Sylius V2 - Improvements with PHP 8 Attr...

07 Dec 2025

Sylius V2 - Symfony Workf...

Sylius V2 - Symfony Workflow Alternative...

06 Dec 2025

Sylius V2 - Symfony 7 Com...

Sylius V2 - Symfony 7 Compatibility

05 Dec 2025

Tags

Meetup Agile API Artificial Intelligence Best Practices Code Quality Documentation E-commerce Ecosystem GDPR Git Performance Plugin Security Sylius Sylius V2 SyliusCon Symfony Testing Tools UX Web Development

Newsletter

SF Sabrine F. Portfolio

Lead Developer, Sylius expert and certified Agile Scrum Developer. Specialized in designing robust e-commerce architectures, I share my technical monitoring and feedback here, primarily focused on the Sylius and Symfony ecosystem.

Useful links

  • Home
  • Portfolio
  • Blog
  • About
  • Contact
  • Sitemap

Areas of expertise

  • #Sylius E-commerce
  • #Agility & SCRUM
  • #Software Architecture

Contact

contact@sabrineferchichi.fr

© 2026 Sabrine F. — All rights reserved

Designed with by Sabrine F.