Git Workflow

Stage all changes at once

git add .

. means add all modified or new files.


Correct commit message format (to avoid commitlint errors)

git commit -m "feat: update about page and fix broken icons"
TypePurpose
featNew feature
fixBug fix
docsDocumentation changes
styleFormatting (no logic change)
refactorCode refactor (not a bug fix)
choreMisc tasks (no functional impact)

Commit message must follow the format type: message, otherwise commitlint or husky will block the commit.


Push to GitHub

git push origin main

Errors I Encountered

YAML syntax error

could not find expected ':' while scanning a simple key

Fix: Open the .yml file in VS Code, check indentation, colons, and quotes — especially in locale files like en.yml.


Local Jekyll Testing

bundle exec jekyll serve

Preview at http://localhost:4000. YAML errors will prevent startup — fix and restart.


Quick Tips

  • Use git status before committing to see what changed
  • If stuck on commit format, --no-verify ignores checks (not recommended long-term)