내 첫 Godot Engine 기여 (그리고 당신도 시작할 수 있는 방법)

Source: Dev.to

왜 이 글을 쓰는가

많은 개발자들처럼 나도 매일 오픈 소스를 사용하지만, 기여는 언제나 위협적으로 느껴졌다—거대한 코드베이스, 수천 개의 파일, 매우 경험이 풍부한 개발자들. 결국 나는 Godot Engine에 첫 번째 실제 기여를 했고, 이 글에서는 다음을 설명한다:

• 내가 기여한 내용
• 오픈 소스를 시작한 방법
• 누구나 따라 할 수 있는 기본 워크플로우

내 풀 리퀘스트는 여기다:
https://github.com/godotengine/godot/pull/115729

큰 기능을 추가하려고 애쓰는 대신, 기존 코드베이스를 이해하고 작고 의미 있는 개선에 집중했다. 이를 통해 배운 점:

• 대규모 프로젝트가 코드를 어떻게 구조화하는지
• 실제 오픈 소스 프로젝트에서 리뷰가 어떻게 진행되는지
• 변경 사항을 명확히 전달하는 방법

가장 큰 교훈: 첫 번째 기여는 크기가 아니라 정확해야 한다.

Godot 저장소 시작하기

1. 메인 저장소 포크
   https://github.com/godotengine/godot

2. 포크를 클론

   git clone https://github.com/YOUR_USERNAME/godot.git
   cd godot

3. 업스트림 원격 추가 (원본 프로젝트와 동기화 유지)

   git remote add upstream https://github.com/godotengine/godot.git

기본 워크플로우

기능 브랜치 만들기

git checkout -b my-fix

master 혹은 main에 직접 변경을 가하지 말 것.

빌드 및 테스트

푸시하기 전에 프로젝트가 정상적으로 빌드되는지 확인한다.

변경 커밋하기

git add .
git commit -m "Fix: clear description of the change"

• 커밋은 최소화하고 하나의 목적에 집중할 것.

푸시하고 풀 리퀘스트 열기

git push origin my-fix

그런 다음 GitHub에서 Pull Request를 연다. PR 설명에 다음을 명확히 적는다:

• What (무엇을) 변경했는지
• Why (왜) 이 변경이 필요한지
• 고려한 edge cases (예외 상황)

리뷰 프로세스

당신의 풀 리퀘스트는 유지관리자들이 검토한다. 다음과 같은 요청을 받을 수 있다:

• 코드의 일부를 업데이트하거나 개선하기
• 추가 테스트나 문서 작성하기

이러한 요청은 정상적인 것이며 오픈 소스 협업의 일환이다. 리뷰는 비판이 아니라 배우고 개선할 기회이다.

내가 얻은 것

• 대규모 소프트웨어가 어떻게 구축되는지에 대한 통찰
• 기존 코드를 읽고, 실제 이슈를 고치며, 공개적으로 변경을 논의하는 경험
• 작지만 잘 만든 기여가 가치 있다는 자신감

유용한 자료

• 공식 기여 가이드: https://contributing.godotengine.org/en/latest/organization/how_to_contribute.html

댓글 섹션에 질문을 자유롭게 남겨 주세요.