Skip to content

Commit 6a25734

Browse files
author
Dhia Ayachi
committed
Add readme file
1 parent bc23f52 commit 6a25734

File tree

1 file changed

+33
-0
lines changed

1 file changed

+33
-0
lines changed

cmd/changelog-gen/README.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
# changelog-gen
2+
3+
`changelog-gen` is a command that will generate a changelog entry based on the information passed and the information retrieved from the Github repository.
4+
5+
The changelog template by default is as follow but also can be passed as parameter:
6+
7+
```gotemplate
8+
```release-note:{{ .Type}}
9+
{{if eq .URL ""}}{{if eq .Service ""}}{{.Description}}.{{else}}{{.Service}}: {{.Description}}.{{end}}{{else}}{{if eq .Service ""}}{{.Description}}. [GH-{{.Pr}}]({{.URL}}){{else}}{{.Service}}: {{.Description}}. [GH-{{.Pr}}]({{.URL}}){{end}}{{end}}
10+
```
11+
12+
The type parameter can be one of the following:
13+
* bug
14+
* note
15+
* enhancement
16+
* new-resource
17+
* new-datasource
18+
* deprecation
19+
* breaking-change
20+
* feature
21+
22+
23+
## Usage
24+
25+
```sh
26+
$ changelog-gen -type improvement -service monitoring -description "optimize the monitoring endpoint to avoid losing logs when under high load"
27+
```
28+
if parameters are missing the command will prompt to fill them, the pr number is optional and if not provided the command will try to guss it based on the current branch name (current folder)
29+
30+
31+
## Results
32+
33+
Any failures will be logged to stderr. The entry will be written in the current folder

0 commit comments

Comments
 (0)