본문으로 건너뛰기
최종 수정: 에

커뮤니티 기여 가이드

Apache Doris는 전 세계의 개발자, 사용자, 기술 문서 작성자, 발표자, 커뮤니티 운영자를 환영합니다. 코드 개발, 콘텐츠 제작, 커뮤니티 활동을 통해 기여할 수 있습니다. 어떤 방식으로 참여하든 프로젝트의 성장에 도움이 되며, 기여자에게는 오픈 소스 협업에 참여한 공개 기록이 남습니다.

코드 개발

추천 대상: Doris 개발에 직접 참여하고 싶은 기여자.

  • 버그를 수정하고 새로운 기능을 개발합니다.
  • 성능, 안정성, 관측 가능성을 개선합니다.
  • 단위 테스트, 회귀 테스트, 통합 테스트를 추가합니다.
  • 빌드, CI, 릴리스, 개발 도구, 엔지니어링 작업 흐름을 개선합니다.
  • PR을 검토하고 기술 문서, 사용자 문서, 예제를 추가합니다.

기여한 내용이 병합되면 Apache Doris Contributor가 됩니다.

가이드 읽기 ->

콘텐츠 제작

추천 대상: Doris 활용 사례를 알고 실무 경험을 공유하고 싶은 기여자.

  • 기술 블로그 글과 프로덕션 환경 사례 연구를 작성합니다.
  • 시작하기 튜토리얼과 모범 사례를 만듭니다.
  • 기능, 배포, 튜닝, 문제 해결에 관한 영상을 제작합니다.
  • 밋업, 웨비나, 콘퍼런스에서 발표합니다.
  • 문서, 블로그 글, 행사 자료, 영상 자막을 번역합니다.

양질의 콘텐츠를 기여하면 감사의 뜻으로 커뮤니티 기념품을 드립니다.

가이드 읽기 ->

커뮤니티 활동

추천 대상: 사용자의 요구를 이해하고 사람들과 함께하는 일을 즐기는 기여자.

  • Slack, GitHub, 메일링 리스트에서 질문에 답합니다.
  • 새로운 사용자가 적절한 문서, 예제, 커뮤니티 채널을 찾도록 돕습니다.
  • 온·오프라인 밋업, 워크숍, 질의응답 시간, 사용자 발표를 기획합니다.
  • 사용자가 프로덕션 환경 운영 경험과 마이그레이션 사례를 공유하도록 초대합니다.
  • 사용자 의견을 수집해 공개 커뮤니티 채널에 공유합니다.

적극적으로 참여하는 커뮤니티 구성원에게는 감사의 뜻으로 커뮤니티 기념품을 드립니다.

가이드 읽기 ->

기여 혜택

기여의 종류, 품질, 지속성에 따라 다음과 같은 혜택을 받을 수 있습니다.

  • Apache Doris 커뮤니티 채널에서 공개적으로 기여를 인정받을 수 있습니다.
  • 기여자 목록, 커뮤니티 감사 인사, 행사 후기에서 기여를 소개받을 수 있습니다.
  • Apache Doris 웹사이트, 블로그, 소셜 채널, 영상 채널에 콘텐츠를 게시할 기회를 얻을 수 있습니다.
  • 커뮤니티 행사에서 발표할 기회를 얻을 수 있습니다.
  • Maintainer, Committer, PMC 구성원, 경험 많은 사용자와 교류할 기회가 늘어납니다.
  • 일부 밋업, 웨비나, 콘퍼런스 세션 또는 다른 커뮤니티 프로그램에 우선 참여할 수 있습니다.
  • 기술 기여와 개인적 성과에 관한 공개 기록을 남길 수 있습니다.
  • 커뮤니티 기념품이나 특별 선물을 받을 수 있습니다.

높은 수준의 기술 기여를 꾸준히 이어 온 구성원은 Apache 거버넌스 절차를 거쳐 Apache Doris Committer 또는 PMC 구성원으로 초대받을 수 있습니다. Doris Summit은 매년 주목할 만한 기여를 한 사용자, 개발자, 커뮤니티 활동가에게 감사를 전하기 위해 Outstanding Community Heroes를 선정합니다.

커뮤니티 참여 가이드​

아래에서 각 참여 방식의 시작 방법을 설명합니다.

팁

커뮤니티 절차가 발전함에 따라 이 가이드는 변경될 수 있습니다. 최신 소식은 Apache Doris Slack 커뮤니티에서 확인하세요.

기여할 작업을 찾는 곳​

다음 채널에서 기여할 기회를 찾을 수 있습니다.

  • Slack: 질문하거나 토론을 시작하고, 배경 정보를 확인하거나, 대화할 담당자를 찾을 수 있습니다.
  • Apache Doris GitHub Issues: 버그, 기능 요청, 개선 아이디어, 진행할 작업을 찾기에 좋습니다.
  • Apache Doris GitHub Discussions: 기술 토론, 사용 관련 질문, 설계 제안에 적합합니다.
  • 로드맵: 장기적인 기술 작업을 찾기에 좋습니다. 보통 GitHub Issues 페이지에 고정된 Issue에서 확인할 수 있습니다.
  • 기존 PR: 검토, 테스트, 검증에 참여하거나 변경 사항이 진행되도록 돕기에 좋습니다.

처음 기여한다면 문서 수정, 테스트 추가, 간단한 버그 수정, Issue 재현, 오류 메시지 개선, 예제 정리처럼 범위가 작고 명확한 작업부터 시작할 수 있습니다. 규모가 큰 기능이나 동작 변경은 Apache Doris Slack의 #dev 채널에서 토론을 시작하고 Core Maintainer에게 배경 정보를 물어보세요.

코드 기여 시 지켜야 할 사항​

코드를 제출하기 전에 다음 사항을 확인하세요.

  • apache/doris 저장소를 포크하고 최신 main 브랜치에서 별도 브랜치를 만듭니다.
  • 각 PR은 하나의 명확한 문제에 집중합니다. 관련 없는 변경 사항을 한 PR에 섞지 않습니다.
  • PR 제목과 설명에 목표, 범위, 검증 결과를 적습니다.
  • 관련 Issue, Discussion 또는 메일링 리스트 대화를 연결합니다.
  • 필요한 단위 테스트, 회귀 테스트 또는 수동 검증 절차를 추가합니다.
  • 변경 사항이 사용자 동작, 설정, SQL 의미 체계, 오류 메시지 또는 호환성에 영향을 주면 문서를 업데이트합니다.
  • 호환성, 성능, 안정성 또는 동작에 관한 위험을 PR 설명에 명시합니다.

좋은 PR에는 일반적으로 다음 내용이 포함됩니다.

  • 배경: 변경이 필요한 이유.
  • 접근 방식: 무엇을 왜 변경했는지.
  • 테스트: 실행한 테스트나 검증 절차와 그 결과.
  • 위험: 변경 사항이 호환성, 성능, 안정성 또는 사용자 동작에 영향을 주는지.
  • 문서: 문서 업데이트가 필요한지, 필요하다면 어디를 업데이트했는지.

커뮤니티는 코딩, 디버깅, 검토에 AI를 활용하는 것을 지원하지만, 기여자는 다음 규칙을 따라야 합니다.

  • 개발, 디버깅, 검토에는 충분한 성능을 갖춘 모델을 사용합니다. 중요한 변경 사항에 품질이 낮은 생성 코드에 의존하지 않습니다.
  • 제출한 코드에 대한 책임은 제출자에게 있습니다. 커뮤니티는 사람이 책임지지 않는 AI 생성 코드를 받지 않습니다.

표준 병합 절차​

코드 변경은 일반적으로 다음 절차를 거칩니다.

  1. 기여자가 Pull Request를 엽니다.
  2. Committer 또는 그보다 높은 권한을 가진 사람이 CI와 AI Review를 실행합니다. 도움이 필요하면 Slack #dev 채널에서 요청할 수 있습니다.
  3. 기여자가 CI와 검토에서 보고된 빌드, 테스트, 형식 문제를 수정합니다. AI 피드백도 검토 과정의 일부입니다. 유용한 제안은 반영하고, 적용할 수 없는 제안은 PR에서 이유를 설명합니다.
  4. 필요한 경우 기여자가 최신 main 브랜치에 맞춰 리베이스하고 충돌을 해결합니다.
  5. 필수 CI 검사를 모두 통과합니다.
  6. Reviewer가 PR을 승인합니다.
  7. Committer가 병합을 완료합니다.

PR을 병합하려면 필수 CI 검사를 통과해야 합니다. 필수가 아닌 검사는 병합을 막지 않습니다.

검토를 진행하는 방법​

기여자는 Reviewer를 기다리기만 하지 말고 자신의 PR이 진행되도록 적극적으로 도와야 합니다. Apache Doris 기여 가이드에서도 기여자가 자신의 PR에서 Moderator 역할을 맡아 제출부터 병합까지 진행하는 것을 권장합니다.

권장 사항은 다음과 같습니다.

  • PR 설명에 Reviewer에게 필요한 배경 정보를 충분히 제공합니다.
  • Slack #dev 채널에 PR 링크를 공유하고 Reviewer를 요청합니다.
  • 검토 의견에 신속히 답합니다.
  • 지적된 사항을 처리한 뒤 해결됨으로 표시합니다.
  • 의견에 동의하지 않을 때는 기술적 근거를 설명합니다.
  • 충돌이 오래 누적되지 않도록 정기적으로 리베이스합니다.
  • PR 진행이 멈췄다면 관련 Reviewer에게 PR에서 정중하게 다시 확인을 요청합니다.
  • 누가 PR을 검토해야 할지 모르겠다면 Slack에서 적절한 모듈 담당자를 찾는 데 도움을 요청합니다.

적절한 Reviewer를 찾는 방법은 다음과 같습니다.

  • 같은 모듈에서 최근 병합된 PR을 살펴봅니다.
  • 관련 파일의 커밋 기록을 확인합니다.
  • 사용할 수 있다면 GitHub에서 추천하는 Reviewer나 CODEOWNERS를 확인합니다.
  • Slack에서 적절한 Reviewer를 찾는 데 도움을 요청하되, 중요한 기술적 결론은 GitHub나 메일링 리스트에도 공유합니다.

커뮤니티 행동 강령​

모든 기여자는 다음 원칙을 따라야 합니다.

  • 다른 사람을 존중하고 전문적이며 친절하고 건설적으로 소통합니다.
  • 중요한 기술 토론과 커뮤니티 결정은 가능하면 공개 채널에서 진행합니다.
  • 코드, 문서, 콘텐츠에 대한 검토 의견을 열린 마음으로 받아들입니다.
  • 검토 의견에 동의하지 않을 때는 기술적 근거를 명확히 설명합니다.
  • 공개적으로 논의해야 할 커뮤니티 사안을 비공개로 결정하지 않습니다.
  • 직접 만든 콘텐츠를 제출하고, 인용하거나 참고한 자료는 출처를 명확히 밝힙니다.
  • 과장되거나 검증할 수 없거나 오해를 부르는 성능 및 비즈니스 관련 주장을 피합니다.
  • 가능한 경우 코드 변경에 대한 테스트를 추가합니다.
  • 변경 사항이 사용자에게 보이는 동작에 영향을 주면 문서를 업데이트합니다.
  • 사용자의 개인정보, 고객의 민감한 정보 또는 회사의 기밀 정보를 공개하지 않습니다.
  • 보안 문제는 책임 있는 공개 절차를 따릅니다. 문제가 처리되기 전에 공개 채널에 세부 사항을 게시하지 않습니다.
  • Apache 커뮤니티의 가치와 ASF Code of Conduct를 존중합니다.

기여자는 오픈 소스 커뮤니티의 구성원으로 참여합니다. 일부 활동에서 회사를 대표한다면 필요한 경우 그 사실을 밝히세요. 기여 활동 자체는 기여를 중시하는 Apache의 개방적이고 투명한 협업 방식을 따라야 합니다.

Report issue