Discussions 고정 게시글 초안
저장소 Settings → Discussions → Pin discussion에서 아래 내용을 사용합니다. Announcements 분류에 게시하는 것을 권장합니다. 해당 분류가 없다면 먼저 General에 게시하고 공지로 설정하세요.
게시글 1: NotionNext 커뮤니티 참여 환영(고정 권장)
제목: [공지] NotionNext 커뮤니티 유지보수에 참여하세요
본문(아래 내용 복사):
안녕하세요.
NotionNext는 개인 저장소에서 조직 **notionnext-org**로 이전되었으며, 커뮤니티 협업 유지보수로 전환 중입니다. 사이트 운영자든 개발자든 누구나 참여를 환영합니다.
이렇게 참여할 수 있습니다
| 하고 싶은 일 | 어디로 가야 하나요 |
|---|---|
| 배포 배우기, 설정 수정 | 사용 설명 문서 사이트 |
| 질문, 경험 공유 | 이 Discussions의 사용 Q&A에 게시(Issue보다 적합) |
| 가이드 수정, 오류 정정 | 문서 페이지 하단 GitHub에서 이 페이지 편집 → PR 제출 |
| Bug 수정, 기능 개발 | Contributing → Fork → PR |
| 장기 유지보수, 조직 참여 | 먼저 1-2개 PR 병합 후 조직 구성원 신청 Discussion 작성(템플릿 참고) |
전체 경로: 커뮤니티 참여 가이드
지금 가장 도움이 필요한 일
good first issue라벨이 붙은 작업(주로 문서와 작은 수정)help wanted라벨이 붙은 작업
주의 사항
- Bug(재현 가능) → Issue
- 기능 아이디어 → 먼저 Ideas 분류에서 논의한 뒤 Issue / PR 생성
- 보안 취약점 → 비공개 보고, PoC 공개 금지
- 유지보수자는 자원봉사자이며 상업적 SLA는 없습니다. 친절하게 소통하고 행동 강령을 지켜 주세요.
구버전 Notion 호스팅 가이드는 여전히 docs.tangly1024.com에 있습니다. 새 문서는 저장소 docs/user-guide/를 기준으로 합니다.
모든 Contributor에게 감사합니다.
게시글 2: 유지보수자 역할 분담과 병합 규칙(고정 또는 게시글 1에서 링크 권장)
제목: [공지] 유지보수자 역할 분담과 PR 병합 규칙
본문:
이 글은 누가 무엇을 맡고, 반복 업무를 어떻게 줄일지 설명합니다. 자세한 규칙은 유지보수자 운영 매뉴얼과 프로젝트 거버넌스를 참고하세요.
담당 영역(모집 중, 자원 환영)
| 영역 | 범위 | 현재 |
|---|---|---|
| 문서 사이트 | docs/user-guide/, VitePress | 모집 중 |
| 내장 테마 | themes/<name>/ | 모집 중(테마 문서에 @maintainer 명시 가능) |
| CI / 빌드 | .github/workflows/ | 모집 중 |
| 데이터 계층 / Notion API | lib/db/ 등 | @tangly1024 게이트키핑 |
| 릴리스 / 조직 | tag, Secrets, 구성원 초대 | Org Admin |
담당 방식: 몇 개의 PR이 병합된 뒤 조직 구성원 신청 템플릿으로 게시하거나, 이 글에 맡고 싶은 영역을 댓글로 남깁니다.
병합 규칙(요약)
- 모든 변경은 PR로 진행하며 CI를 통과해야 합니다(lint, 타입 검사, 테스트, lockfile; 문서는 VitePress 빌드 추가).
- 문서만 변경(
documentation라벨 /docs/**): Write 권한 유지보수자가 Review 후 병합할 수 있으며, Founder 필수 리뷰가 필요 없습니다. - 영향이 큰 경로(
lib/db,next.config.js,package.json등): CODEOWNERS 검토가 필요합니다(보통 Founder). - Dependabot PR: 유지보수자가 매주 일괄 Review 후 병합합니다(기본적으로 major 업그레이드는 제외).
분류(유지보수자는 전달하고, Founder에게 긴 DM을 보내지 않도록 안내)
- 사용 관련 질문 → 사용 Q&A Discussion
- 중복 Issue → duplicate로 닫고 기존 글 링크
- 환경 정보 부족 →
needs-info표시 후 버전/테마/배포 방식 보완 요청 - 장기 비활동 → Stale workflow가 자동 처리
조직 참여 조건을 충족했지만 초대를 받지 못했나요?
반복 DM을 보내지 마세요. Discussion 템플릿 조직 구성원 신청으로 글을 올리고 GitHub 사용자명과 병합된 PR 링크를 첨부하세요.
게시 완료(2026-05-17)
| 게시글 | 링크 |
|---|---|
| 커뮤니티 참여 환영 | https://github.com/notionnext-org/NotionNext/discussions/4069 |
| 유지보수자 역할 분담과 병합 규칙 | https://github.com/notionnext-org/NotionNext/discussions/4070 |
분류: Announcements. Discussions 목록에서 위 두 게시글에 각각 Pin discussion을 눌러 고정하세요(API는 아직 자동 Pin을 지원하지 않음).
게시 단계(다시 게시해야 할 때)
- https://github.com/notionnext-org/NotionNext/discussions/new/choose 열기
- Announcements 분류 선택
- 위의 해당 제목과 본문 붙여넣기
- 게시 후 Pin discussion
- (선택) 게시글 1 링크를 조직 Profile README에 추가
본문을 수정한 뒤에는 위 Discussion 페이지도 함께 편집하세요.