Skip to content

Generate Release Notes in markdown format from GitHub projects using Oktokit and LibGit2Sharp.

License

Notifications You must be signed in to change notification settings

StefH/GitHubReleaseNotes

Repository files navigation

GitHubReleaseNotes

Generate Release Notes from GitHub.

dotnet tool

NuGet Badge GitHubReleaseNotes

Installation

dotnet tool install --global GitHubReleaseNotes

WinGet

winget install -e --id StefHeyenrath.GitHubReleaseNotes

Chocolatey

Chocolatey downloads Chocolatey

Installation

choco install GitHubReleaseNotes

Usage

GitHubReleaseNotes can be run inside a git repository.

GitHubReleaseNotes --path . --output ReleaseNotes.md --version 1.0.4.17 --language en --skip-empty-releases --exclude-labels question

Arguments:

  • --path: The path from the git repository. If not supplied, the current folder is used.
  • --output: The location from the generated Release Notes. If not supplied, the output is written to the console.
  • --version: Define a custom version name for the latest release instead of the value "next".
  • --language: Provide the language (two letter according to ISO-639-1) which is used to format the dates. If not provided, "en" is used. It's also possible to use a value like "system", which takes the current system ui language.
  • --skip-empty-releases: Define this optional argument to skip writing releases which have no associated Issues or Pull Requests.
  • --template: Provide a custom Handlebars template instead of the default template to generate the Release Notes.
  • --exclude-labels: Exclude Issues and Pull Requests which have these labels set.
  • --exclude-labels: To exclude issues from the generated output, provide a space separated string list from label-names you want to exclude.
  • --token: Provide the GitHub API token as authentication for connecting to private repositories. @
  • --login and --password: Provide the GitHub API login and password as authentication for connecting to private repositories. @

@ you only can use one authentication method

Output

The generated Release Notes (Markdown formatted) will look like:

# 1.0.4.16 (11 September 2018)

 - [#202](https://github.com/StefH/GitHubReleaseNotes/pull/202) - Update logic PR contributed by [StefH](https://github.com/StefH)
 - [#201](https://github.com/StefH/GitHubReleaseNotes/issues/201) - Fix issue abc

Copyright

Notes

This project is based on GitTools/GitReleaseNotes.

Dependencies

About

Generate Release Notes in markdown format from GitHub projects using Oktokit and LibGit2Sharp.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages