https://github.com/emiliosheinz/release-notes-generator
📝 Easily generate release notes for your projects
https://github.com/emiliosheinz/release-notes-generator
javascript release-note release-notes-generateor
Last synced: 6 months ago
JSON representation
📝 Easily generate release notes for your projects
- Host: GitHub
- URL: https://github.com/emiliosheinz/release-notes-generator
- Owner: emiliosheinz
- License: mit
- Created: 2022-04-14T20:27:57.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2022-12-28T21:25:14.000Z (over 3 years ago)
- Last Synced: 2025-10-20T09:11:51.506Z (9 months ago)
- Topics: javascript, release-note, release-notes-generateor
- Language: JavaScript
- Homepage:
- Size: 93.8 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 📝 release-notes-generator
Easily generate changelog files.
## Getting Started
### Install
We assume that you already have `node v14.0.0` or higher installed.
To install rng just run:
```
npm i -g rng-cli
```
Or if you prefer:
```
yarn global add rng-cli
```
## Usage
Run `rng --help` to see all available parameters.
## Available commands
- `withGitHub`: Generates release notes from GitHub
- `withLocalFile`: Generates release notes from a local file, by default it tries to read `CHANGELOG.md`.
## Available options
Available options for each command
### withGitHub
- `-o, --organizationName`: The name of the GitHub organization where your project is placed.
- `-p, --projectNumber`: The number of the project in which your cards are beeing shown. This number can be found at the URL of the project.
- `-t, --token`: Your personal token. Don't forget to give `org` and `repo` admin permission.
- `-l, --label`: Pass any valid label if you want to filter your return with one.
- `-c, --column`: Pass the name of the colon that you want to use to generate the data. This is required.
- `-r, --repository`: Pass the name of the repository that you want to filter cards.
- `-s, --isSorted`: Use to asc sort by card issue number.
- `-m, --milestone`: Pass any valid milestone if you want to filter your return with one. The default value is null, when null return all cards. If you only want to return cards that do not have a milestone, send `__NONE__` as parameter.
### withLocalFile
- `-f, --file`: The path to the file where the changelog is located. Default is `CHANGELOG.MD`
## Other info
When you are using `withLocalFile` command, remember to separate each version with the separator `---`, the scripts will base the result of your changelog on it.
Ex:
```
0003 My third change
---
0002 My second change
0001 My first change
```
If you run the script based on the file above, it will return everything above `---`, so the result will be:
```
0003 My third change
```