improve revert example #136

New Issue

GiteaMirror · 2026-02-17T11:48:57-06:00

GiteaMirror commented

2026-02-17 11:48:57 -06:00

Originally created by @privatenumber on GitHub (Nov 8, 2021).

Description

The example set for the "revert" type can be improved:

118d24b0ca/content/v1.0.0/index.md (L193)

revert: let us never again speak of the noodle incident

Refs: 676104e, a215868

This is a poor example because it doesn't follow the format of Conventional Commits:

<type>[optional scope]: <description>

The "description" let us never again speak of the noodle incident is not a description of the commit, but rather some obscure inside joke/reference that provides no immediate insight to new contributors that are trying to skim a commit log.

Proposal

Change to something like:

revert: broken gallery feature

Refs: 676104e, a215868

Originally created by @privatenumber on GitHub (Nov 8, 2021). ## Description The example set for the "revert" type can be improved: https://github.com/conventional-commits/conventionalcommits.org/blob/118d24b0ca7822493fc4beb97451b0249ae9b4e1/content/v1.0.0/index.md?plain=1#L193 > revert: let us never again speak of the noodle incident > > Refs: 676104e, a215868 This is a poor example because it doesn't follow the format of Conventional Commits: ``` <type>[optional scope]: <description> ``` The "description" `let us never again speak of the noodle incident` is not a description of the commit, but rather some obscure inside joke/reference that provides no immediate insight to new contributors that are trying to skim a commit log. ## Proposal Change to something like: > revert: broken gallery feature > > Refs: 676104e, a215868

GiteaMirror referenced this issue

2026-02-17 11:58:29 -06:00

[PR #136] [CLOSED] Add 'resolves:' type for message body #310

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: github-starred/conventionalcommits.org#136