[Kafka 개발] 카프카 프로젝트에 컨트리뷰트 하는 방법

들어가며

카프카의 공식 문서 중 How to contribute에 대한 (의역에 가까운) 번역 본입니다. 오역이 있을 수 있으니 틀린 부분 혹은 틀린 것 같은 부분은 댓글로 남겨주시길 바랍니다. 또한 작성일 기준으로 이후 변경된 부분이 있을 수 있습니다. 작성일과 최근 수정일을 참고해 주시길 바랍니다.

컨트리뷰트 하는 방법

사소한 코드 정리부터 커다란 기능 추가까지 모든 기여를 환영합니다.

자바 혹은 스칼라에 대해 몰라도 이 프로젝트에 기여할 수 있습니다. 가장 중요한 부분은 클라이언트 부분입니다. 우리-앞으로의 우리는 카프카 진영을 이야기합니다-는 좋은 품질의 코드와 문서를 가지는 여러 언어 클라이언트를 원합니다. 이건 카프카에 관한 툴들을 구성하는 것만큼 카프카 프로젝트에서 매우 중요한 부분입니다.

코드만이 유일한 기여 방법이 아닙니다. 우리는 문서 또한 큰 가치로 생각하며, 문서에 대한 기여도 매우 환영합니다.

이슈 리포팅

잠재적 이슈를 지라 티켓으로 리포팅하는 것은 프로젝트 기여만큼이나 환영합니다. 그러나 지라 티켓을 궁금증 해결을 위해 사용하는 것은 금물입니다. 만약 질문이나 이슈가 될만한 것인지 잘 모르겠다면, 티켓을 만들기 전에 먼저 우리에게 연락하세요. 그리고 새로운 티켓을 만드려면 이 설명 페이지를 참고하세요.

코드 변경에 관한 기여 방법

변경된 부분을 제출하기 전에 아래 과정을 따라주세요

1. 사소한 변경이 아니라면 새로운 기능에 대해 단위 테스트를 포함하세요.
2. 완전히 새로운 기능이나 API를 제시한다면, 위키부터 시작하여 관련 기초 디자인에 관한 컨센서스를 먼저 얻으세요.
3. 스타일 가이드를 따라주세요.
4. 만약 변경된 부분이 유저에 직접적인 프로토콜 / 인터페이스 / 설정 등이라면 변경과 관련된 문서를 잘 작성해야 합니다. 위키 페이지는 직접 수정이 가능합니다(만약 위키를 처음 작성한다면 권한을 얻기 위해 우리에게 연락이 필요할 수 있습니다). 그리고 웹 사이트에 게시되는 문서는 코드 레포지토리의 `docs` 아래 부분으로 구성되기 때문에 관련된 수정은 코드를 PR 하는 것과 동일하게 하면 됩니다. 웹 사이트 문서를 변경하는 방법은 아래에서 설명합니다.
5. 변경을 지속적으로 추적하는 것이 우리의 일입니다. 만약 우리가 일을 하고 있지 않는다면 조르셔도 됩니다. (종종 안할 때가 있습니다)

웹 사이트 변경에 관한 기여 방법

변경된 부분을 제출하기 전에 아래 과정을 따라주세요

1. 웹 사이트를 기여하는 방법에 관한 문서를 따라주세요.
2. 변경을 지속적으로 추적하는 것이 우리의 일입니다. 만약 우리가 일을 하고 있지 않는다면 조르셔도 됩니다. 만약 변경에 대한 개선이 필요하다면, 리뷰어가 리뷰를 진행한 다음 지라 티켓 상태를 "In Progress"로 변경할 것입니다.

기여할 작업 찾기

코드를 기반으로한 작업을 시작하는 가장 쉬운 방법은 지라에서 티켓을 고르고 작업하는 것입니다. 이 방법은 당신이 코드를 이해하고, 시스템을 빌드하고, 리뷰를 진행하는 것 등과 친숙해질 수 있도록 도와줍니다. 초보자를 위한 버그들은 이곳에 정리해놨습니다.

지라 계정의 username을 기여자 목록에 추가하고 싶다면 제공되는 이메일로 우리에게 연락하세요. 이후 당신은 스스로 작업하기로 한 지라 티켓을 배정할 수 있으며, 이는 다른 사람들에게 알려질 것입니다.

만약 작업 내용이 "중요한 변경(major change)"이라 생각되면 해당 지라 티켓을 포함하는 Kafka Improvement Proposal(KIP)을 생성해야 합니다. KIP 위키 페이지를 생성하기 위해선 권한이 필요하니, 권한을 얻기 위해선 우리에게 연락하세요.

한번 코드를 살펴보는 과정을 거치고 나면, 당신은 좀 더 실질적인 프로젝트를 진행하기 원할겁니다. 우리는 이러한 프로젝트를 큐레이션하고 있는데, 이곳에서 찾아볼 수 있습니다.

커밋터 되기 

우리는 언제든지 새로운 기여자를 찾고 있습니다. 우리가 중점적으로 보는 것은 기여했던 것들, 좋은 취향, 그리고 프로젝트에 대한 지속적인 관심입니다. 카프카 PMC는 새로운 커밋터를 발굴하기 위해 아래와 같은 가이드라인을 따르고 있습니다.

• 디자인, 코드, 문서와 같은 영역에서 눈에 띄는 기여를 함. 예를 들어
  • 사소하지 않은 KIP을 제출하고 완료함
  • 치명적인 버그를 수정함 (성능 개선을 포함)
  • 중요한 기술 부채를 해결
  • 중요한 문서 개선(웹 사이트와 java docs) 
• 6개월 내에 아래 중 최소 한 커뮤니티에서 꾸준한 도움을 줌.
  • 메일링 리스트에 참여
  • 코드 리뷰와 KIP 리뷰
  • 테스트와 벤치 마킹 등 릴리즈 검토
  • 기술 세미나나 블로그 포스팅 등 외부 활동
• 이해한 것은 입증하고, core, clients, connect, streams, tests 등 중 최소 한 영역에 기여하고 적절한 기술적인 판단을 함