README.md

TOAST UI Tools: Release Notes

Github release notes generator.

🚩 Table of Contents

• Features
• Install
• Usage
  • Add a config file
• Pull Request Steps
• Contributing
• TOAST UI Family
• License

🎨 Features

• Create a release note from a tag.
• Group commits by their types.
• Add links to download.

💾 Install

TOAST UI products can be used by using the package manager or downloading the source directly. However, we highly recommend using the package manager.

Via Package Manager

TOAST UI products are registered in two package managers, npm. You can conveniently install it using the commands provided by each package manager. When using npm, be sure to use it in the environment Node.js is installed.

npm

$ npm install --save-dev @toast-ui/release-notes # Latest version
$ npm install --save-dev @toast-ui/release-notes@<version> # Specific version

Download Source Files

• Download all sources for each version

🔨 Usage

1. Check package.json has repository property. Repository url should end with .git.

"repository": {
  "type": "git",
  "url": "https://github.com/username/repository-name.git"
}

// or for short expression
"repository": "https://github.com/username/repository-name.git"

2. Register Github access token by TUI_GITHUB_TOKEN as an environment variable or token property in tui-note.config.js. To generate a token, please refer to this.

// tui-note.config.js
module.exports = {
  token: 'your-github-token-for-toast-ui-release-notes'
}

3. Add the command as a script to the project's package.json file.

scripts: {
  "note": "tui-note"
}

4. Execute the command on your project root.

# tag specified in the tui-note.config.file
# if you do not set a tag in a config file, latest tag
npm run note

# specific tag
# it will overwrite a tag in a config file
npm run note -- --tag={specific-tag}

Add a config file

Add your config files to the root of your working directory. The config file must be in the form of tui-note.config.js.

Option	Type	Description
token	string	Github access token for toast-ui.release-notes. If you pass a token as an environment variable, it will be overwritten.
tag	string	Tag to create a release note. If you pass a tag as the command line argument, it will be overwritten. (default: the latest tag)
apiUrl	string	Github API url. If you use the enterprise github, set your enterprise github url (ex. github.your-enterprise-url.com/api/v3). (default: https://api.github.com)
groupBy	object	Determine how to categorize commits by their types. 'key' is group name and 'value' is array of types. (default: defaultConfig.groupBy)
commitMessage.type	function	Determine how to get a type from a commit message. (default: defaultConfig.commitMessage.type)
template.commit	function	Note from a commit. (default: defaultConfig.template.commit)
downloads	function | object	Links to download the files. (reference: defaultConfig.downloads)

🔧 Pull Request Steps

TOAST UI products are open source, so you can create a pull request(PR) after you fix issues. Run npm scripts and develop yourself with the following process.

Setup

Fork master branch into your personal repository. Clone it to local computer. Install node modules. Before starting development, you should check to have any errors.

$ git clone https://github.com/{your-personal-repo}/toast-ui.release-notes.git
$ cd toast-ui.release-notes
$ npm install
$ npm run test

Develop

Let's start development! Don't miss adding test cases and then make green rights.

Run karma test

$ npm run test

Pull Request

Before PR, check to test lastly and then check any errors. If it has no error, commit and then push it!

For more information on PR's step, please see links of Contributing section.

💬 Contributing

• Code of Conduct
• Contributing guideline
• Issue guideline
• Commit convention

🍞 TOAST UI Family

• TOAST UI Editor
• TOAST UI Calendar
• TOAST UI Chart
• TOAST UI Image-Editor
• TOAST UI Grid
• TOAST UI Components

📜 License

This software is licensed under the MIT License © NHN.