Skip to content

Latest commit

 

History

History
43 lines (30 loc) · 1.23 KB

concepts.rst

File metadata and controls

43 lines (30 loc) · 1.23 KB

Concepts

Fragments

Fragments are files describing your latest work, created by the "cmd_create" command. The files are created in the changelog.d directory (settable with config_fragment_directory). Typically, they are committed with the code change itself, then later aggregated into the changelog file with "cmd_collect".

Categories

Changelog entries can be categorized, for example as additions, fixes, removals, and breaking changes. The list of categories is settable with the config_categories setting.

If you are using categories in your project, new fragments will be pre-populated with all the categories, commented out. While editing the fragment, you provide your change information in the appropriate category. When the fragments are collected, they are grouped by category into a single changelog entry.

You can choose not to use categories by setting the config_categories setting to empty.

Entries

Fragments are collected into changelog entries with the "cmd_collect" command. The fragments are combined in each category, in chronological order. The entry is given a header with version and date.