dfe-analytical-services / analysts-guide

A static website to hold guidance, helpful links and code examples for analysts working in DfE.
https://dfe-analytical-services.github.io/analysts-guide/
MIT License
3 stars 0 forks source link

Add git commit message guidance #31

Closed cjrace closed 8 months ago

cjrace commented 8 months ago

Overview of changes

Add guidance on how to write good commit messages when using Git.

Why are these changes being made?

It's a question we regularly get from new starters, plus I wanted a place to stash a link to the Git commit convention site too for future reference.

Detailed description of changes

  1. Have moved the commits section above the branches section under 'Tips for using Git' as it felt like a more logical starting place (though up for debate!)
  2. Added generic advice on committing regularly (another frequent question we get)
  3. Moved the existing commit guidance into a specific 'In RStudio section'
  4. Added details on how to write good commit messages and a link to the commit conventions site

Screenshot of a local build showing the formatting of the new guidance: image

Issue ticket number/s and link

N/A - though there is a Trello card on our SDT board that Tess had added some notes to.

Checklist before requesting a review