Commit

• 1st line: Max 80 character summary
  • Written in past tense e.g. “Fixed the thing” not “Fixes the thing”
  • Start with one of: Fixed, Changed, Updated, Improved, Added, Removed, Reverted, Moved, Released, Bumped, Cleaned
• 2nd line: [Always blank]
• 3rd line: ref <issue link>, fixes <issue link>, closes <issue link> or blank
• 4th line: Why this change was made - the code includes the what, the commit message should describe the context of why - why this, why now, why not something else?

If your change is user-facing please prepend the first line of your commit with an emoji.

Because emoji commits are the release notes, it's important that anything that gets an emoji is a user-facing change that's significant and relevant for end-users to see.

The first line of an emoji commit message should be from the perspective of the user. For example, 🐛 Fixed a race condition in the members service is technical and tells the user nothing, but 🐛 Fixed a bug causing active members to lose access to paid content tells the user reading the release notes “oh yeah, they fixed that bug I kept hitting.”

Main emojis we are using:

• ✨ Feature
• 🎨 Improvement / change
• 🐛 Bug Fix
• 🌐 i18n (translation) submissions
• 💡 Anything else flagged to users or whoever is writing release notes

Example

✨ Added config flag for disabling page analytics

ref https://linear.app/tryghost/issue/ENG-1234/

- analytics are brand new under development, therefore they need to be behind a flag
- not using the developerExperiments flag as that is already in wide use and we aren't ready to deploy this anywhere yet
- using the term `pageAnalytics` as this was discussed as best reflecting what this does