ThorVG Core에 기여하고 싶어도 처음에는 어떤 이슈를 봐야하는지 막막할 수 있습니다.
작업 범위를 이해할 수 있는 이슈를 고르는 것부터 시작해 보세요.
AI 리뷰를 보고 어떤 이슈인지 살펴보기
사이트의 이슈 페이지에서 프로젝트 필터의 thorvg/thorvg를 선택해 보세요.
AI 분석이 준비된 Core 이슈에는 난이도 점수와 AI 리뷰 표시가 나타납니다.
해당 이슈를 누르면 AI 리뷰 페이지가 열립니다.
리뷰에서는 위와 같은 내용을 빠르게 훑어볼 수 있습니다.
“난이도”와 “관련 영역”과 “배울 수 있는 것” 항목을 보고 이슈에 도전해보세요.
IMPORTANT
AI 리뷰는 정답이나 공식 가이드가 아닙니다. 흐름만 파악하여 흥미로운 주제인지 자신이 기여할 수 있을 것인지 판단용으로만 사용하세요. 이슈에 도전하시는 분은 이슈에 코멘트를 달거나 멘토분들에게 문의하시면 됩니다. 실제 코드와 최신 이슈 대화가 다르면 저장소의 코드와 메인테이너의 설명을 기준으로 판단해 주세요. 해당 AI 리뷰는 업데이트 주기가 느린 정적 리뷰입니다. 만약, 다른 분에게 할당된 작업이라면, 진행중인 작업인지 해당 이슈에 문의를 남겨보세요.
시작 전 체크리스트
- CONTRIBUTING.md과 코드 컨벤션을 충분히 숙지하셨나요?
- 이슈 원문과 최근 댓글을 읽었나요?
- 담당자나 진행 중인 Pull Request가 없는지 확인했나요?
- 관련 코드를 직접 열어 AI 리뷰와 비교했나요?
- 변경 전 동작을 재현하거나 기존 테스트를 실행했나요?
- 작업 방향이 불분명하면 이슈 댓글로 먼저 질문했나요?
- 변경 후 thorvg.example 프로젝트에 있는 예제들에 대해 테스트를 해보셨나요? (ex. Lottie, Animation .. )
- 프로젝트 환경 설정, 코드 리뷰를 위한 SKILL를 활용하여 더 재미있게 기여해봅시다!
성능 관련 이슈인 경우
- thorvg.example 프로젝트의 예제를 실행하면 fps 로그를 볼 수 있습니다.
- 성능 측정은 여러번 측정하고 평균을 내는 방식으로 확인해야합니다.
- 특히, HW 영향을 많이 받으므로, 다양한 기기와 플랫폼(1~2개)에서 테스트하고 PR을 작성할 때 측정한 fps 의 퍼센테이지 수치를 공유하세요.
- ex) gl: web, windows, linux, android
- main 과 PR 커밋분이 반영된 main 과 비교하면 됩니다.
IMPORTANT
FPS 측정치를 PR 이나 ISSUE 에 남기는 것 보다는 +10%, -10% 같이 퍼센테이지 수치를 사용하세요 하드웨어같은 환경에 따라 FPS 는 언제든지 변할 수 있습니다. 평균을 사용하세요, FPS 측정은 평균 FPS 가 안정적일때까지 실행하고, 어느정도 안정화 되면 기록하세요.
처음부터 큰 수정에 도전할 필요는 없습니다. 이해할 수 있는 작은 이슈 하나를 고르고, 코드와 테스트로 가설을 확인하는 것부터 시작해 보세요.
댓글
Discussion 원문