Skip to content

Name It, Commit It, Ship It

🎵 “Stage it, commit it, push it, ship it.”
If Daft Punk had written version control, it would sound exactly like Git.

This page is all about naming things with purpose and committing with style — the rhythm that keeps every project dancing in sync.


🗂️ Repository Naming — Keep It Clean, Keep It Clear

Section titled “🗂️ Repository Naming — Keep It Clean, Keep It Clear”

Your repository’s name is its first impression.
Let’s make it classy, descriptive, and easy to remember.

Bad ExampleGood Example
Final_Project_V2webdevtnt-html-forms
stuffportfolio-site
new-repolesson-03-css-dynamite

Rules of thumb:

  • Use kebab‑case (lowercase‑with‑hyphens)
  • Start with context or purpose (lesson‑, assignment‑, demo‑)
  • Avoid spaces, underscores, emojis, and mystery names
  • Bonus: add your course tag (webdevtnt, prof‑solo‑lab, etc.)

💡 Professor Solo’s Pro Tip:
Your repo name should tell the world what it is, not who made it.


🌿 Branch Naming — Order in the Codeverse

Section titled “🌿 Branch Naming — Order in the Codeverse”

Branches are like side quests. Name them well and everyone knows their purpose.

PrefixPurposeExample
feature/New functionalityfeature/add-contact-form
fix/Bug fixfix/navbar-overlap
hotfix/Urgent production patchhotfix/typo-footer
docs/Documentation updatesdocs/readme-formatting
release/Pre‑release stagingrelease/2.0

Style Guide:

  • Always use lowercase + hyphens
  • Keep it short and specific (feature/dark‑mode, not feature/that‑one‑thing‑I‑forgot‑to‑do)
  • No spaces, no chaos

💡 Professor Solo’s Pro Tip:
Branch names are the signposts of teamwork — label them like directions, not riddles.


✍️ Commit Messages — Say What, Not How

Section titled “✍️ Commit Messages — Say What, Not How”

Commit messages tell the story of your project one line at a time.
A good one reads like a newspaper headline — clear, active, and concise.

Format:

type: short description
(optional longer explanation)

Common Types:

TypeMeaningExample
featNew featurefeat: add responsive nav bar
fixBug fixfix: correct padding on hero image
refactorCode restructurerefactor: simplify grid logic
docsDocumentationdocs: update README install guide
styleNon‑functional changesstyle: format CSS for readability
choreMaintenancechore: update dependencies

Examples of Great Commits:

feat: add accessible skip link for keyboard users
fix: correct footer background color on mobile
docs: clarify setup instructions for students

Examples of Not‑So‑Great Commits:

stuff
final update
fixed it again
why won't this work

💡 Professor Solo’s Pro Tip:
Use the imperative mood — “Add feature,” not “Added feature.”
Git already knows who did it and when — your job is to explain what and why.


(with apologies — and respect — to Daft Punk)

Stage it, commit it,
Push it, ship it,
Pull it, merge it,
Fix it, check it,
Tag it, stash it,
Branch it, trash it,
Fetch it, log it,
Push it, ship it.

Every developer has their rhythm. Git just keeps the beat.


✅ Mission Check: Commit to the Groove

Section titled “✅ Mission Check: Commit to the Groove”

By now, we can:

  1. Name repositories clearly and consistently
  2. Create meaningful, readable branch names
  3. Write strong, informative commit messages
  4. Follow conventions that make collaboration smooth
  5. Groove to the rhythm of add‑commit‑push‑repeat

💡 Professor Solo says:

“Code has rhythm. Git is the beat.
Name it, commit it, ship it — and keep the groove clean.”