Commit Helper

CockroachDB Commit Helper

Help the user create properly formatted commit messages and release notes that follow CockroachDB conventions.

Workflow

1. Analyze the changes: Run git diff --staged or git diff to understand what was modified
2. Determine the package prefix: Identify the primary package affected
3. Ask the user for:
   • Issue/epic number if not already known
   • Whether release notes are needed and what category fits best
4. Write the subject line: Imperative mood, no period, under 72 characters
5. Write the body: Explain the before/after, why the change was needed
6. Add issue references: Include Resolves/Epic as appropriate
7. Write the release note: Clear, user-focused description of the change
8. Create the commit using the properly formatted message

Commit Message Structure

Basic Format:

package: imperative title without period

Detailed explanation of what changed, why it changed, and
how it impacts users. Explain the problem that existed
before and how this commit solves it.

Include context about alternate approaches considered and
any side effects or consequences.

Resolves: #123
Epic: CRDB-357