Skip to content

Instantly share code, notes, and snippets.

@andreasonny83
Last active May 11, 2024 19:05
Show Gist options
  • Save andreasonny83/24c733ae50cadf00fcf83bc8beaa8e6a to your computer and use it in GitHub Desktop.
Save andreasonny83/24c733ae50cadf00fcf83bc8beaa8e6a to your computer and use it in GitHub Desktop.
Release Notes Template

Release Notes Template

Based off https://palantir.quip.com/pzRwAVr1bpzf

Pro-tip: look through the github diff between the previous release to see what's changed. The commit titles should give an outline of what's happened.

Upgrade Steps

  • List out, as concretely as possible, any steps users have to take when they upgrade beyond just dumping the dependency.
  • Write pseudocode that highlights what code should change and how.
  • Call out if users are recommended to upgrade because of known problems with older releases.
  • Preferably, there's nothing here.

Breaking Changes

  • A complete list of breaking changes (preferably there are none, unless this is a major version).

New Features

  • Describe the new feature and when/why to use it. Add some pictures! Call out any caveats/warnings? Is it a beta feature?

Bug Fixes

  • Call out any existing feature/functionality that now works as intended or expected.

Improvements

  • Improvements/enhancements to a workflow, performance, logging, error messaging, or user experience

Other Changes

  • Other miscellaneous changes that don't fit into any of the above categories. Try to leave this empty - ideally, all changes fit into the categories above

Copy and paste this template

## [0.0.2](https://github.com/andreasonny83/twilio-remote-cli/compare/v0.0.1...v0.0.2) (2019-07-21)

> Description

### Upgrade Steps
* [ACTION REQUIRED]
* 

### Breaking Changes
* 
* 

### New Features
* 
* 

### Bug Fixes
* 
* 

### Performance Improvements
* 
* 

### Other Changes
* 
* 

Example:

## [0.5.2](https://github.com/andreasonny83/twilio-remote-cli/compare/v0.5.1...v0.5.2) (2019-07-21)

### Performance Improvements

* **dependencies:** Bump dependencies  4a4ee13

### Other Changes

* **chore(conventionalChangelog):** Add Conventional Changelog  aafcdd9
* **docs(CHANGELOG):** Add changelog  e2c7435
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment