diff --git a/.github/DISCUSSION_TEMPLATE.md b/.github/DISCUSSION_TEMPLATE.md index 1740cd4..4f5fac6 100644 --- a/.github/DISCUSSION_TEMPLATE.md +++ b/.github/DISCUSSION_TEMPLATE.md @@ -1,119 +1,102 @@ -# GitHub Discussions Announcement Template / GitHub Discussions 공지 템플릿 +# GitHub Discussion Template / GitHub Discussion 템플릿 -## Metadata / 메타데이터 +## 1. Title / 제목 -- **Category / 카테고리**: `Announcements` -- **Status / 상태**: `Planned`, `In progress`, `Completed` (choose one) / (택1) -- **Related Issue(s) / 관련 이슈**: #ISSUE_ID -- **Related PR(s) / 관련 PR**: #PR_ID -- **Target version / 대상 버전**: e.g. `v0.2.0` +- Write a short, user-facing title that explains the topic. + 사용자가 이해하기 쉬운 짧은 제목을 적습니다. +- Avoid internal-only abbreviations. + 내부에서만 통하는 약어 사용은 피해주세요. ---- +## 2. Type of discussion / 디스커션 유형 -## Title / 제목 + - +- Question / 질문 +- Idea / RFC (proposal) / 아이디어 · RFC(제안) +- Announcement draft / 공지 초안 +- Design discussion / 설계 논의 +- Process / workflow / 프로세스 · 워크플로 + +## 3. Summary / 개요 -## Summary / 개요 +## 4. Background & motivation / 배경 및 문제 의식 -- What is changing? / 무엇이 변경되나요? -- Why are we changing it now? / 왜 지금 변경하나요? -- Who is affected? / 누가 영향을 받나요? +- Current situation / 현재 상황: +- Problems or pain points / 문제점, 불편함: +- Who is affected? / 누가 영향을 받나요?: -## Details / 상세 내용 - -### Motivation / 배경 및 목적 +## 5. Proposal or question details / 제안 또는 질문 상세 -### What is changing / 변경 사항 +- What do you propose or ask? / 무엇을 제안하거나, 무엇을 묻고 있나요? +- How would it work in practice? / 실제로는 어떻게 동작하길 바라나요? +- Example flows, API, or config (if any). / 예시 플로우, API, 설정 등이 있다면 적어주세요. + +## 6. Alternatives & prior art / 대안 및 참고 사례 -- [ ] Behavior change / 동작 변화 -- [ ] Configuration change / 설정 변경 -- [ ] API change / API 변경 -- [ ] Operational change (deployment, monitoring, etc.) / 운영 변경(배포, 모니터링 등) +- Alternatives you considered / 고려했던 대안: +- Pros & cons / 장단점: +- Related tools, standards, or projects / 관련 도구, 표준, 프로젝트: -### Timeline / 일정 +## 7. Impact / 영향 범위 -- Announcement date / 공지 일자: `YYYY-MM-DD` -- Rollout start / 롤아웃 시작: `YYYY-MM-DD` -- Deprecation date / 사용 중단 예정: `YYYY-MM-DD` -- Removal date (if any) / 완전 제거 예정일(선택): `YYYY-MM-DD` +- API / Public surface / API 및 외부 공개 인터페이스: +- Configuration & deployment / 설정 및 배포: +- Security & privacy / 보안 및 프라이버시: +- Performance & reliability / 성능 및 안정성: +- Developer experience / 운영 및 개발자 경험(DX): -## Impact & Risks / 영향 및 리스크 +## 8. Open questions / 열린 질문 -- Affected components / 영향을 받는 컴포넌트: -- Affected users / 영향을 받는 사용자 그룹: -- Risk level / 리스크 수준: `Low`, `Medium`, `High` +- Question 1: +- Question 2: -## Migration / Action items / 마이그레이션 및 필요한 조치 +## 9. Proposed next steps / 다음 단계 제안 -1. Step 1 / 1단계 -2. Step 2 / 2단계 -3. Step 3 / 3단계 - -## How to give feedback / 피드백 방법 - - - -- Open an Issue: link / 이슈 생성 링크 -- Comment under this Announcement / 이 공지에 댓글로 남기기 -- Other channels (if any) / 기타 채널(있는 경우) - -## FAQ (optional) / 자주 묻는 질문 (선택) - - - -- **Q:** - **A:** - -- **Q:** - **A:** \ No newline at end of file +- Who will drive this forward? / 누가 이 작업을 주도하나요? +- Expected timeline (rough) / 대략적인 일정: +- Needed input or reviewers / 필요한 인풋·리뷰어: \ No newline at end of file