커뮤니티 참여
NotionNext는 개인 저장소에서 조직 **notionnext-org**로 이전되었습니다. 사이트 운영자이자 개발자인 참여자들이 코드와 문서를 함께 유지보수하는 것을 환영합니다. 코드, 테마, 문서, Issue, Review, 릴리스 유지보수에 참여한 모든 기여자는 감사의 말 페이지와 GitHub 기여 기록에서 확인할 수 있습니다.
네 단계 참여 경로
1. 사이트 사용 / 문서 읽기
↓
2. 질문(Discussions 또는 Issue)
↓
3. 기여(문서 PR 또는 코드 PR)
↓
4. 유지보수자 되기(선택, 담당 영역 맡기)1. 사용과 읽기
- 온라인 문서: notionnext.tangly1024.com
- 빠른 시작: 소개 → Vercel 배포
- 구버전 Notion 가이드: docs.tangly1024.com(이전 스크린샷)
2. 질문과 논의
| 상황 | 어디로 가야 하나요 |
|---|---|
| 배포/설정 “사용 방법” | GitHub Discussions · 사용 Q&A |
| 특정 가이드가 불명확함 | 해당 페이지 하단 문서 피드백(Giscus) 또는 Discussions · 문서 |
| Bug로 확인됨 | Bug Report Issue |
| 기능 아이디어 | 먼저 Discussions · 아이디어에서 방향을 맞춘 뒤 Issue 생성 |
기술 질문은 GitHub를 우선 사용하세요. 검색 가능하고 자원봉사자가 이어받기 쉽습니다. WeChat/Telegram은 교류 커뮤니티를 참고하세요(비공식 SLA).
3. 첫 기여(문서부터 권장)
- notionnext-org/NotionNext를 Fork합니다.
docs/user-guide/**/*.md를 편집합니다(또는good first issue가 붙은 Issue 수정).- 로컬 미리보기:
yarn docs:site:dev - CONTRIBUTING.zh-CN.md에 따라 PR을 제출합니다.
자세한 흐름: 온라인 문서 유지보수 참여 · 유지보수 워크플로 · 감사의 말
코드 / 테마 수정: 개발자 문서(GitHub) · 기여 가이드를 읽고, 큰 변경은 먼저 RFC(GitHub)를 작성합니다.
4. 유지보수자와 조직 구성원 되기
- 1-2개의 병합된 PR을 완료한 뒤 Discussions에서 담당 영역(문서 / CI / 특정 테마 등)을 자기 추천할 수 있습니다.
- 규칙은 GOVERNANCE.zh-CN.md를, 명단은 MAINTAINERS.md를 참고하세요.
조건을 충족했지만 아직 초대를 받지 못했나요?
조직 협업에 필요한 병합 PR 조건 등을 충족했지만 아직 조직 초대를 받지 못했다면, **GitHub Discussions에 글을 작성**하세요(“조직 구성원 신청” 템플릿 사용 가능). 제목은 조직 구성원 신청으로 쓰고, GitHub 사용자명, 병합된 PR 링크, 맡고 싶은 영역을 첨부하세요. 유지보수자가 Discussion에서 순서대로 답변하며, 초대에는 지연이 있을 수 있습니다.
행동과 거버넌스
지금 가장 도움이 필요한 일
저장소 Issues에서 **good first issue**와 **help wanted**를 필터링하세요. 흔한 작업은 다음과 같습니다.
- 문서 마이그레이션, 오탈자, 4.9.x 설정 설명 동기화
- 단일 테마 설명 또는 스크린샷 갱신
- 번역과
lib/lang보강
유지보수자는 Discussions에 “기여 환영” 게시글을 고정할 예정입니다. 초안은 PINNED_DISCUSSION_POSTS.zh-CN.md를 참고하세요.