콘텐츠로 이동

기여 가이드

Agent Development Kit (ADK)에 기여하는 데 관심을 가져주셔서 감사합니다! 저희는 핵심 프레임워크(Python 및 Java)와 문서 모두에 대한 기여를 환영합니다.

이 가이드는 참여 방법에 대한 정보를 제공합니다.

1. google/adk-python

핵심 Python 라이브러리 소스 코드를 포함합니다.

2. google/adk-java

핵심 Java 라이브러리 소스 코드를 포함합니다.

3. google/adk-docs

현재 읽고 계신 문서 사이트의 소스를 포함합니다.

4. google/adk-web

adk web 개발 UI의 소스를 포함합니다.

시작하기 전에

✏️ 기여자 라이선스 계약(CLA)에 서명해주세요

이 프로젝트에 대한 기여는 기여자 라이선스 계약 (CLA)에 동의해야 합니다. 귀하(또는 귀하의 고용주)는 기여물에 대한 저작권을 보유하며, 이 계약은 프로젝트의 일부로서 귀하의 기여물을 사용하고 재배포할 수 있는 권한을 저희에게 부여하는 것입니다.

만약 귀하 또는 귀하의 현재 고용주가 이미 Google CLA에 서명했다면(다른 프로젝트를 위한 것이었더라도), 다시 서명할 필요는 없습니다.

현재 계약을 확인하거나 새 계약에 서명하려면 https://cla.developers.google.com/을 방문하세요.

📜 커뮤니티 가이드라인을 검토해주세요

이 프로젝트는 Google의 오픈 소스 커뮤니티 가이드라인을 따릅니다.

💬 토론에 참여하세요!

질문이 있거나, 아이디어를 공유하고 싶거나, ADK를 어떻게 사용하고 있는지 논의하고 싶으신가요? 저희 Python 또는 Java 토론(Discussions)으로 오세요!

이곳은 다음과 같은 주요 소통 공간입니다:

  • 커뮤니티와 유지보수자에게 질문하고 도움받기.
  • 여러분의 프로젝트나 사용 사례 공유하기 (Show and Tell).
  • 공식적인 이슈를 생성하기 전에 잠재적인 기능이나 개선 사항에 대해 논의하기.
  • ADK에 대한 일반적인 대화.

기여하는 방법

ADK에 기여할 수 있는 몇 가지 방법이 있습니다:

1. 이슈 보고하기 (버그 및 오류)

프레임워크에서 버그를 발견하거나 문서에서 오류를 찾은 경우:

2. 개선 제안하기

새로운 기능이나 기존 기능 개선에 대한 아이디어가 있으신가요?

3. 문서 개선하기

오타, 불분명한 설명 또는 누락된 정보를 찾으셨나요? 변경 사항을 직접 제출하세요:

4. 코드 작성하기

버그 수정, 새로운 기능 구현 또는 문서용 코드 샘플 기여를 도와주세요:

방법: 코드 변경 사항이 포함된 Pull Request (PR)를 제출하세요.

코드 리뷰

  • 프로젝트 멤버의 기여를 포함한 모든 기여는 리뷰 과정을 거칩니다.

  • 저희는 코드 제출 및 리뷰를 위해 GitHub Pull Request (PR)를 사용합니다. PR에 변경 사항을 명확하게 기술해주세요.

라이선스

기여함으로써 귀하는 귀하의 기여물이 프로젝트의 Apache 2.0 라이선스에 따라 라이선스가 부여된다는 데 동의하는 것입니다.

질문이 있으신가요?

막히거나 질문이 있으면, 관련 리포지토리의 이슈 트래커에 자유롭게 이슈를 열어주세요.