Configuration can be split per kind of change to allow more flexibility. Most configurations are optional and will default to the shared formatting values when omitted.
Example of a two line breaking change:
kinds:
- label: Breaking
header: "## :warning: Breaking"
skipGlobalChoices: true
changeFormat: >-
* {{.Reason}}
{{.Body}}
additionalChoices:
- key: Reason
label: Reason for breaking change
type: string
type: string
| default: ""
| required
Label is the only required element for kinds. This value is shown to users as part of the Kind selection prompt. It is also the value saved in change files.
type: string
| default: ""
| optional
Format allows you to override the header output. Overrides the shared kind format when specified.
Format Arguments
Field | Type | Description |
---|---|---|
Kind | string | Kind label value |
type: string
| default: ""
| optional
Change format allows you to override the output of a change for each kind. Overrides the shared change format when specified.
type: bool
| default: false
| optional
Whether or not our kind will skip the default body prompt.
type: bool
| default: false
| optional
Whether or not our kind will skip the global choices configuration. This allows you to create kinds that have a specific set of custom choices separate from the other kinds.
type: []
Choice | default: empty
| optional
Additional choices is a list of custom choices identical to the global choices but for only this one kind. These choices will be asked after the global choices. You will need to create a custom change format to use the new choices.