Skip to content

Oxc에 기여하기

Oxc에 기여해 주셔서 감사합니다! 우리는 다음 세대의 자바스크립트 도구를 구축하고 있으며, 여러분의 도움을 절실하게 기다리고 있습니다.

빠른 시작

가장 빠르게 시작하는 방법은 우리의 좋은 첫 번째 이슈를 살펴보는 것입니다. 이러한 작업들은 신규 기여자에게 완벽하게 적합하도록 신중히 선택된 과제들입니다.

안내가 필요하신가요? 우리 팀과 커뮤니티 멤버들이 기꺼이 도와주는 디스코드 커뮤니티에 가입해 보세요.

기여 방법

모든 형태의 기여를 환영하고 존중합니다:

🐛 버그 보고

  • 파싱 오류 또는 잘못된 린팅 동작 보고
  • 성능 문제나 회귀 현상 공유
  • 우리가 고려하지 않은 예외 사례 문서화

🚀 기능 개발

  • 새로운 린팅 규칙 추가
  • 파서 호환성 향상
  • 트랜스포머 기능 강화
  • Oxc 에코시스템 내 새 도구 개발

📚 문서화

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

🧪 테스트

  • 실제 월드 코드베이스에서 테스트 케이스 추가
  • 테스트 커버리지 향상
  • 성능 벤치마크 생성
  • 에코시스템 프로젝트와 함께 테스트

🔧 인프라 구조

  • 빌드 및 CI 시스템 개선
  • 개발용 도구 강화
  • 성능이 중요한 경로 최적화
  • 기타 도구들과의 호환성 유지

코드베이스 이해하기

Oxc는 여러 크레이트로 구성되어 있습니다:

  • oxc_parser: 고성능 자바스크립트/타입스크립트 파서
  • oxc_linter: 650개 이상의 규칙을 갖춘 빠른 린팅 엔진
  • oxc_transformer: 타입스크립트 및 JSX 변환
  • oxc_minifier: 자바스크립트 최소화 (개발 중)
  • oxc_formatter: Prettier와 호환되는 코드 포맷터 (알파 버전)

처음 기여하기

  1. 이슈 검색: 좋은 첫 번째 이슈 라벨이 붙은 이슈를 찾아보세요
  2. 질문하기: 디스코드 또는 깃허브에서 설명이 필요하면 망설이지 말고 질문하세요
  3. 작은 것부터 시작하기: 문서 개선이나 작은 버그 수정부터 시작하세요
  4. 패턴 익히기: 기존 코드를 분석하여 우리의 약속을 이해하세요

커뮤니티

소통 채널

  • 깃허브 디스커션: 설계 논의 및 질문용
  • 디스코드: 팀 및 커뮤니티와 실시간 채팅
  • 깃허브 이슈: 버그 보고 및 기능 요청용
  • 트위터: @boshen_c를 팔로우하여 업데이트 확인

행동 강령

모든 사람에게 친근하고 포용적인 경험을 제공하기 위해 노력하고 있습니다. 참여하기 전에 행동 강령을 읽어주세요.

인공지능 사용 정책

인공지능 도구(예: ChatGPT, Claude, Copilot 등과 같은 언어 모델 포함)를 이용해 Oxc에 기여할 때:

  • 인공지능 사용 여부를 반드시 공개하여 유지보수자의 피로도를 줄이세요
  • 모든 인공지능 생성된 이슈나 프로젝트 제안에 대해 책임을 지세요
  • 품질이 낮거나 검토되지 않은 인공지능 콘텐츠는 즉시 닫힐 수 있습니다

우리는 개발을 지원하기 위해 인공지능 도구의 사용을 장려하지만, 모든 기여물은 제출 전에 기여자가 철저히 검토하고 테스트해야 합니다. 인공지능으로 생성된 코드는 반드시 이해하고 검증되며, Oxc의 기준에 맞게 적절히 조정되어야 합니다.

다음 단계

기여를 준비하셨나요? 아래에서 시작하기 좋은 곳들을 추천합니다:

함께 어떤 것을 만들지 기다릴 수 없습니다! 🚀