Name It, Commit It, Ship It
Name It, Commit It, Ship It
Section titled “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 Example | Good Example |
|---|---|
Final_Project_V2 | webdevtnt-html-forms |
stuff | portfolio-site |
new-repo | lesson-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.
| Prefix | Purpose | Example |
|---|---|---|
feature/ | New functionality | feature/add-contact-form |
fix/ | Bug fix | fix/navbar-overlap |
hotfix/ | Urgent production patch | hotfix/typo-footer |
docs/ | Documentation updates | docs/readme-formatting |
release/ | Pre‑release staging | release/2.0 |
Style Guide:
- Always use lowercase + hyphens
- Keep it short and specific (
feature/dark‑mode, notfeature/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:
| Type | Meaning | Example |
|---|---|---|
feat | New feature | feat: add responsive nav bar |
fix | Bug fix | fix: correct padding on hero image |
refactor | Code restructure | refactor: simplify grid logic |
docs | Documentation | docs: update README install guide |
style | Non‑functional changes | style: format CSS for readability |
chore | Maintenance | chore: update dependencies |
Examples of Great Commits:
feat: add accessible skip link for keyboard usersfix: correct footer background color on mobiledocs: clarify setup instructions for studentsExamples of Not‑So‑Great Commits:
stufffinal updatefixed it againwhy 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.
💥 The Technologic of Git
Section titled “💥 The Technologic of Git”(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:
- Name repositories clearly and consistently
- Create meaningful, readable branch names
- Write strong, informative commit messages
- Follow conventions that make collaboration smooth
- 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.”