From edc321a7f503ab73e2b1f9d36d072cd7b9531bd2 Mon Sep 17 00:00:00 2001
From: Taesu <166604494+bytaesu@users.noreply.github.com>
Date: Mon, 27 Apr 2026 09:32:30 +0900
Subject: [PATCH] chore: add detailed changeset guides for contributing (#9362)

---
 CONTRIBUTING.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index faed955703..3ecd5b143e 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -189,6 +189,13 @@ Pick the bump type based on user impact:
 - **`patch`** for bug fixes and additive changes existing users don't need to know about.
 - **`minor`** or **`major`** for anything existing users need to be aware of (see [Branch Targeting](#branch-targeting)).
 
+A good description:
+
+- Write for end users reading the changelog, not for the PR reviewer.
+- Be clear and concise.
+- Explain what changed, not a commit-style prefix (e.g. `fix:`, `feat:`).
+- Describe the symptom users see, not the internal cause.
+
 If you're not sure whether your change needs one, a maintainer will handle
 it before merge.