Skip to content

Oxc 기여

Oxc 기여에 관심 가져 주셔서 감사합니다. 차세대 JavaScript 도구를 만들고 있으며, 여러분의 도움을 환영합니다.

빠른 시작

가장 빠른 시작은 good first issues입니다. 새 기여자에게 맞는 작업을 골라 두었습니다.

방향이 필요하면 Discord 커뮤니티로 오세요. 팀과 커뮤니티가 돕습니다.

기여하는 방법

어떤 형태의 기여도 환영합니다.

🐛 버그 리포트

  • 파싱 오류나 잘못된 린트 동작 보고
  • 성능 문제·회귀 공유
  • 아직 고려하지 않은 엣지 케이스 문서화

🚀 기능 개발

  • 새 린트 규칙 추가
  • 파서 적합성 향상
  • 트랜스포머 기능 강화
  • Oxc 생태계의 새 도구

📚 문서

  • 시작 가이드 개선
  • 예제·튜토리얼 추가
  • 아키텍처 결정 문서화
  • 다른 언어로 콘텐츠 번역

🧪 테스트

  • 실제 코드베이스에서 온 테스트 케이스 추가
  • 테스트 커버리지 개선
  • 성능 벤치마크 작성
  • 생태계 프로젝트에 대한 테스트

🔧 인프라

  • 빌드·CI 시스템 개선
  • 개발 도구 강화
  • 성능 핵심 경로 최적화
  • 다른 도구와의 호환 유지

코드베이스 이해

Oxc는 여러 크레이트로 구성됩니다.

  • oxc_parser: 고성능 JavaScript/TypeScript 파서
  • oxc_linter: 650개 이상 규칙을 갖춘 빠른 린팅 엔진
  • oxc_transformer: TypeScript·JSX 변환
  • oxc_minifier: JavaScript 압축(개발 중)
  • oxc_formatter: Prettier 호환 코드 포매터

첫 기여

  1. 이슈 둘러보기: good first issue 라벨
  2. 질문하기: Discord나 GitHub에서 망설이지 말고 물어보기
  3. 작게 시작: 문서 개선이나 작은 버그 수정부터
  4. 패턴 익히기: 기존 코드를 보며 관례 이해하기

커뮤니티

소통 채널

  • GitHub Discussions: 설계 논의·질문
  • Discord: 팀·커뮤니티와 실시간 채팅
  • GitHub Issues: 버그·기능 요청
  • Twitter: @boshen_c 팔로우

행동 강령

모두에게 열린 경험을 제공하기 위해 참여 전 행동 강령을 읽어 주세요.

AI 사용 정책

Oxc 기여 시 AI 도구(ChatGPT, Claude, Copilot 등)를 쓸 때:

  • AI 사용을 밝혀 주세요 — 메인테이너 피로를 줄입니다
  • 제출하는 이슈·PR에 대해 본인이 책임집니다
  • 품질 낮거나 검토 없는 AI 산출물은 즉시 닫을 수 있습니다
  • 반복적으로 저품질("slop") PR을 올리는 기여자는 경고 없이 차단될 수 있습니다. 이 정책에 맞춰 기여하기로 하면 차단 해제를 요청할 수 있습니다. Discord로 문의하세요.

AI 활용은 장려하지만, 모든 기여는 제출 전에 기여자가 충분히 검토·테스트해야 합니다. AI가 만든 코드는 이해·검증·Oxc 기준에 맞게 다듬은 뒤 올려야 합니다.

다음 단계

기여를 시작하기 좋은 곳:

함께 무엇을 만들지 기대합니다! 🚀