Skip to content
GitLab
Projects Groups Snippets
  • /
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in
  • nomad-FAIR nomad-FAIR
  • Project information
    • Project information
    • Activity
    • Labels
    • Members
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
  • Issues 223
    • Issues 223
    • List
    • Boards
    • Service Desk
    • Milestones
  • Merge requests 33
    • Merge requests 33
  • CI/CD
    • CI/CD
    • Pipelines
    • Jobs
    • Schedules
  • Deployments
    • Deployments
    • Environments
    • Releases
  • Packages and registries
    • Packages and registries
    • Package Registry
    • Container Registry
    • Infrastructure Registry
  • Monitor
    • Monitor
    • Incidents
  • Analytics
    • Analytics
    • Value stream
    • CI/CD
    • Repository
  • Snippets
    • Snippets
  • Activity
  • Graph
  • Create a new issue
  • Jobs
  • Commits
  • Issue Boards
Collapse sidebar

On Monday, 27th March 9 a.m., the user backend of GitLab will get a reconfiguration. A new login to the web interface may be necessary.

  • nomad-labnomad-lab
  • nomad-FAIRnomad-FAIR
  • Merge requests
  • !1016

Resolve "Add a automatically generated changelog to our git"

  • Review changes

  • Download
  • Email patches
  • Plain diff
Merged Markus Scheidgen requested to merge 1223-add-a-automatically-generated-changelog-to-our-git into develop Dec 28, 2022
  • Overview 6
  • Commits 4
  • Pipelines 5
  • Changes 4

This adds automatically updated CHANGELOG.md to the project. The mechanism uses GitLabs build in changelog mechanism and is triggered when a release tag is added to git.

We have an automatically generated changelog in the repository file CHANGELOG.md. This changelog is produced from commit messages and to maintain this file, you need to write commit messages accordingly.

To trigger a changelog entry, your commit needs to end with a so called git trailer called Changelog. A typical commit message for a changelog entry should look like this:

A brief one line title of the change.

A longer *markdown* formatted description of the change. Keep in mind that gitlab
will automatically link the changelog entry with this commit and a respective merge
requests. You do not need to manually link to any gitlab resources.

This could span multiple paragraphs. However, keep it short. Documentation should
go into the actual documentation, but you should mention breaks in backward compatibility,
deprecation of features, etc.

Changelog: Fixed

The trailer value (Fixed in the example) has to be one of the following values:

  • Fixed, for bugfixes.
  • Added, for new features.
  • Changed, for general improvements, e.g. updated documentation, refactoring, improving performance, etc.

These categories are consistent with (keepachangelog.com)[https://keepachangelog.com/]. For more information about the changelog generation read the gitlab documentation.

Closes #1223 (closed)

Edited Jan 10, 2023 by Markus Scheidgen
Assignee
Assign to
Reviewers
Request review from
Time tracking
Source branch: 1223-add-a-automatically-generated-changelog-to-our-git