Skip to content

Keep a Changelog

Source identity:

ddx:
  id: resource.keep-a-changelog
  authoring:
    home: repo

Keep a Changelog

Source

Summary

Keep a Changelog provides a structured format for communicating software changes in a human-readable way. It recommends grouping notable changes under clear categories such as added, changed, deprecated, removed, fixed, and security, and emphasizes writing for people rather than only machines or commit history.

Relevant Findings

  • Release communication should summarize notable user-impacting changes rather than dump raw commit history.
  • Categories help readers quickly identify new features, fixes, removals, security items, and required attention.
  • Human-readable change summaries remain valuable even when automation can collect underlying issues or commits.
  • Version and date context help readers understand what shipped and when.

HELIX Usage

This resource informs the Release Notes artifact. HELIX uses it to keep release notes scoped to shipped change, user/operator impact, required actions, known issues, and references to deeper evidence.

Authority Boundary

This resource is a changelog format, not a deployment checklist or launch plan. HELIX Release Notes may borrow its reader-centered categories without becoming a repository changelog.

Innsigle seal: model-primary by HELIX

The signature covers the markdown source of this page, not these HTML bytes. This page quotes that seal; verify it against the source file.

Composition
model-primary
Issuer
HELIX helix
Signing key
ed25519:b0865d76d834a52c48506414d16f4e5a (build key)
Signed source
research/keep-a-changelog.md
Signed
2026-09-23T14:11:58Z
Content digest
sha256:d7f799c3…a680c7f9

This build key is endorsed by the human key for build signing; the signature is not a detector and not a truth guarantee.

Raw attestation JSON
{
  "payload": {
    "innsigle": "1",
    "type": "https://innsigle.dev/claim/colophon/v1",
    "issued_at": "2026-09-23T14:11:58Z",
    "issuer": {
      "id": "helix",
      "name": "HELIX",
      "key_id": "ed25519:b0865d76d834a52c48506414d16f4e5a",
      "key_url": "https://documentdrivendx.github.io/helix/.well-known/innsigle/keys.json"
    },
    "subjects": [
      {
        "uri": "https://documentdrivendx.github.io/helix/research/keep-a-changelog/",
        "digest": {
          "alg": "sha256",
          "value": "d7f799c3576f22c5c2db53136389ec0ead5f7c4abc59ce8b9ba97727a680c7f9"
        }
      }
    ],
    "colophon": {
      "schema_version": "1",
      "composition": "model-primary",
      "ingredients": [
        {
          "kind": "model",
          "name": "Claude",
          "role": "draft"
        },
        {
          "kind": "tool",
          "name": "sloptimizer",
          "role": "rewrite"
        },
        {
          "kind": "human",
          "name": "operator",
          "role": "structure-edit"
        }
      ],
      "notes": null
    }
  },
  "payload_encoding": "json",
  "signatures": [
    {
      "key_id": "ed25519:b0865d76d834a52c48506414d16f4e5a",
      "alg": "ed25519",
      "sig": "MMlKbyz1brSycVu61gl0aGqFmBEZYCU61_GibqtrV0p5JWNh_33qhqQv7qK7ycpufI3JK13ZK8-byD9Ol08FDg",
      "signed_at": "2026-09-23T14:11:58Z"
    }
  ]
}

attestation file · issuer keys