스프린트 가이드¶
BeeWare 스프린트에 오신 것을 환영합니다!¶
환영합니다! 저희와 함께하기로 결정해 주셔서 정말 기쁩니다! 아직 소개를 하지 않으셨다면 아직 꿀벌 팀원 중 한 명에게 자신을 소개하지 않으셨다면, 지금 바로 소개해 주세요. 일단 여기로 돌아와서 시작하세요.
스프린트란 무엇인가요?¶
스프린트는 몇 시간 또는 며칠 동안 오픈소스 프로젝트에 대해 오픈 소스 프로젝트에서 협업할 수 있는 정형화된 기회입니다. 스프린트는 종종 컨퍼런스; 컨퍼런스 후 스프린트는 다음과 같은 기회를 제공합니다. 컨퍼런스에서 생성된 에너지, 열정, 관심을 우리가 사용하는 소프트웨어의 개선에 우리가 매일 사용하는 소프트웨어의 개선으로 전환할 수 있는 기회를 제공합니다.
스프린트는 사람들에게 프로젝트에 기여하는 과정을 소개할 수 있는 기회이기도 합니다. 프로젝트에 기여할 수 있는 기회이기도 합니다. 저희의 바람은 여러분이 스프린트 기간 동안 너무 재미있어서 스프린트 기간 동안 너무 재미있어서 집에 돌아가서도 계속 계속 기여해 주셨으면 합니다!
경험이 얼마나 많든 상관없습니다. 지난 스프린트에서는 고등학생, 부트캠프 졸업생, 자신을 프로그래머로 여기지 않는 사람들, 노련한 개발자 등 모든 경험 수준의 사람들이 기여한 내용을 통합했습니다. 여러분의 경험 수준이 어떻든, 기여할 수 있는 방법을 찾아낼 수 있습니다.
코드만이 기여를 할 수 있는 유일한 방법은 아닙니다. 다음과 같은 프로젝트 BeeWare와 같은 프로젝트는 단순한 코드 그 이상의 의미를 갖습니다, 문서 교정 및 번역, 웹 페이지의 디자인을 개선하고 웹 페이지의 디자인, 심지어 몇 년 전에 보고된 버그를 검토하여 수년 전에 보고된 버그를 검토하고 그 과정에서 버그가 수정되었는지 확인하는 과정도 귀중한 기여입니다.
초기 질문들¶
시작하기 전에 몇 가지 질문을 통해 관심사와 경험을 파악할 수 있도록 몇 가지 질문을 드리겠습니다. 이를 통해 가장 적합한 방법을 찾는 데 도움이 될 것입니다. 가장 좋은 방법을 찾는 데 도움이 될 것입니다. 질문을 살펴보고 메모한 다음, 꿀벌 팀원을 찾아서 꿀벌 팀원을 찾아 답변을 공유하세요. 질문을 이해하지 못하더라도 이해하지 못하더라도 걱정하지 마세요! 알고 있는 내용을 알려주세요. 알려주시면 함께 해결해 나가도록 노력하겠습니다.
- BeeWare를 사용해 본 적이 있나요?
아직 시작하지 않았다면 BeeWare 튜토리얼부터 진행해 보세요. 이 튜토리얼은 BeeWare 프로젝트가 무엇인지, 그리고 프로젝트의 각 부분이 어떻게 조화를 이루는지 소개해 줄 것입니다. 튜토리얼 진행 중 문제가 발생하면 메모해 두세요. 다른 사람이 같은 문제를 겪지 않도록 하는 것이 첫 기여로 삼기 좋은 주제이기 때문입니다!
튜토리얼을 최소한 4단계까지 완료한 후 다음 질문으로 넘어가세요.
- 어떤 컴퓨터 장비를 가지고 계십니까?
소지한 장비는 기여할 수 있는 범위에 실질적인 한계를 둡니다. 예를 들어, Windows 노트북을 사용한다면 iOS 관련 작업은 불가능합니다. 노트북 운영체제는 Windows, macOS, Linux 중 어느 것입니까? 휴대폰은 iOS 기기입니까, Android 기기입니까? 해당 기기들은 회사에서 제공받은 것입니까, 아니면 개인 소유입니까?
- 파이썬 코드 작성 경험은 얼마나 되시나요?
프로그래밍을 막 시작하셨나요? 파이썬 베테랑이신가요? 코딩 베테랑이지만 파이썬을 막 배우기 시작하셨나요? 부트캠프 프로그램을 갓 수료하셨나요? 여러분의 경험 수준에 딱 맞는 문제를 찾아드리고 싶습니다.
- GitHub 기여 프로세스에 익숙하신가요?
자신의 코드를 호스팅하거나 다른 사람의 프로젝트에 기여하기 위해 GitHub(또는 유사한 코드 공유 사이트)를 사용하시나요? CI(지속적
통합)가 무엇인지 아시나요? 프리커밋 훅이 있는 프로젝트에 기여해 본 적이 있나요? 만약 제가 "메인 브랜치에 대한 PR을
rebase해 주세요"라고 요청한다면, 어떻게 해야 할지 아시겠나요?
- 오픈소스 프로젝트에 기여해 본 적이 있나요?
과거에 스프린트에 참여한 적이 있나요? 오픈소스 프로젝트에 PR(풀 리퀘스트)을 제출해 본 적이 있나요? 풀 리퀘스트를 생성하기 위해 GitHub를 사용하는 방법에 익숙하신가요?
- 유용할 만한 다른 특별한 기술이 있나요?
GUI API(예: WinForms, Cocoa, GTK)에 익숙하신가요? 특정 운영 체제의 내부 구조에 대한 깊은 지식을 가지고 계신가요? 파이썬 이외의 프로그래밍 언어에 전문성을 갖추고 계신가요? 특별한 기술이 없더라도 문제될 것은 없습니다. 다만, 우리 팀에 윈도우 전문가가 있다면 그 능력을 제대로 활용할 수 있도록 하고 싶습니다.
- 왜 저희와 함께하게 되셨으며, 어떤 분야에 관심이 있으신가요?
"친근한 프로젝트 같아서"라는 답변도 충분히 괜찮습니다. 하지만 오늘 저희와 함께하게 된 이유가 더 있다면 알려주세요. 모바일이나 데스크톱 개발에 관심이 있으신가요? 패키징? 웹사이트? 콘솔 앱? 특별한 관심사가 없다면, 지금까지 BeeWare에 대해 보신 내용 중 가장 흥미로워 보이는 부분은 무엇인가요?
이제 꿀벌 팀원을 찾아 답을 공유하세요. 그들은 몇 가지 후속 질문을 몇 가지 후속 질문을 할 수도 있습니다. 여러분이 기여할 수 있는 분야를 알려줄 것입니다.
문제점 찾기¶
Bee 팀 멤버와 이야기해 본 적이 있다면, 그들은 아마도 여러분이 기여할 수 있는 BeeWare 프로젝트의 일부를 알려주었을 것입니다. 심지어 작업할 특정 이슈를 제안했을 수도 있죠. 만약 구체적인 이슈를 제시하지 않았다면, 해당 프로젝트의 "좋은 첫 번째 이슈"을 안내했을 가능성이 높습니다. 그게 무슨 뜻일까요?
GitHub는 BeeWare(및 기타 프로젝트)가 보고된 모든 문제를 추적할 수 있는 이슈 목록을 제공합니다. 여기에는 명시적인 버그, 버그일 수 있는 예기치 않은 동작이 포함됩니다, 새로운 기능에 대한 요청, 더 많은 문서 요청 - 모든 것이 포함됩니다. BeeWare를 개선할 수 있는 모든 것을 포함합니다. 새로운 이슈가 보고되면 보고되면, Bee 팀은 그 중 일부를 처음 기여하는 사용자에게 첫 번째 기여자에게 적합한 이슈 - 즉각적인 수정이 필요하지 않지만 즉각적인 수정이 필요하지 않지만, 잘 정의되어 있거나 재현하기 쉽고, 아마도 근본적인 원인에 대한 좋은 단서를 가지고 있습니다. 이러한 이슈에는 "좋은 첫 번째 이슈"라는 태그를 붙여 쉽게 찾을 수 있도록 합니다.
GitHub 이슈 목록을 "좋은 첫 번째 이슈" 레이블로 필터링하려면 다음 단계를 따르세요:
- 문제 목록 위의 "라벨" 버튼을 클릭하여 드롭다운 메뉴를 활성화하세요.
- 드롭다운 메뉴 상단의 검색창에 "good"이라는 단어를 입력하세요.
- 필터링된 목록에서 "좋은 첫 호"를 클릭하세요.
"좋은 첫 번째 이슈" 레이블로 GitHub 이슈 필터링하기.
흥미로워 보이는 이슈를 찾았다면 해당 게시물의 모든 게시물의 댓글을 읽고 토론에 댓글을 달아주세요. 해당 이슈를 조사하고 있음을 알리는 댓글(예: "파이콘 US에서 이 문제를 조사 중입니다. 2025 스프린트에서 이 문제를 살펴보고 있습니다."). BeeWare는 명시적으로 문제를 "할당"하지 않습니다. 기여를 받습니다. 하지만 스프린트 상황에서는 다음과 같이 해야 합니다. 두 사람이 같은 이슈에 대해 작업하는 일이 없도록 해야 합니다. 두 사람이 같은 이슈를 작업하는 일이 없도록 해야 합니다. 코멘트를 남기는 것은
그래도 하고 싶은 일을 찾지 못하셨다면 Bee 팀 멤버에게 문의하면 특정 이슈로 범위를 좁히는 데 도움을 받을 수 있습니다.
개발 환경 설정¶
문제를 발견한 후에는 개발 환경을 설정해야 합니다. 환경을 설정해야 수정 작업을 할 수 있습니다. 각 BeeWare 프로젝트에는 고유한 기여 가이드가 있습니다:
프로젝트가 이 목록에 없는 경우 프로젝트 README에서 자세한 내용을 확인하세요. 에서 설정 방법을 확인하세요. 설명 중 이해가 되지 않는 부분이 있으면(또는 해당 지침을 찾을 수 없는 경우) Bee 팀원을 찾으면 도움을 받으실 수 있습니다. 그리고 - 다른 사람들이 지침을 개선하여 다른 사람들이 같은 문제에 부딪히지 않도록 개선할 수 있다면 가이드 개선은 귀중한 기여입니다!
이제 문제 해결을 시작할 수 있습니다!
PR을 제출한 후에는 어떻게 되나요?¶
풀 리퀘스트를 제출하고 풀 리퀘스트가 모든 자동화된 검사를 통과하면 모든 자동화된 검사를 통과하면 검토할 준비가 된 것입니다. 핵심 팀 중 한 명에게 팀 중 한 명에게 PR을 검토할 준비가 되었다는 사실을 알려주면 살펴볼 것입니다.
첫 번째 PR인 경우 검토에서 몇 가지 문제가 발견될 가능성이 높습니다. 문제가 발견될 가능성이 높습니다. 미처 고려하지 못한 엣지 케이스이거나 코드 규칙을 준수하지 않았을 수도 있습니다. 낙담하지 마세요! 아무도, 심지어 심지어 핵심 팀조차도 첫 번째 시도에서 100% 정확한 PR을 얻을 수는 없습니다.
PR이 검토를 통과하면 검토자가 PR을 병합합니다. 이제 끝났습니다! 축하합니다. BeeWare에 기여하셨습니다! 이것이 BeeWare에 대한 첫 번째 기여라면, BeeWare 도전 코인도 획득하셨습니다. 핵심 팀 멤버를 찾아가면 코인을 받을 수 있습니다!
도와줘! 난 막혔어!¶
도중에 어느 지점에서든 막히면 꿀벌 팀원을 찾아주세요. 팀원을 찾으세요. 무엇이든 질문하는 것을 두려워하지 마세요. 막힌 부분이 있다면, 저희는 도와드리겠습니다. 혼란스러우신다면 주제가 주제가 복잡하고 저희가 충분히 설명하지 않았기 때문입니다. 저희는 기꺼이 도와드리고 싶고, 성공적인 스프린트가 될 수 있도록 최선을 다하고 있습니다.
스프린트 기간 동안 기여를 완료하지 못하면 어떻게 되나요?¶
문제없어요! 언제든지 기여를 제출하실 수 있습니다. 스프린트의 목표는 여러분이 올해 남은 기간 동안 계속해서 기여할 수 있도록 격려하고 힘을 실어주는 것입니다. Bee 팀은 이 과정의 어떤 부분이라도 도움을 드릴 수 있습니다.
이미 GitHub 이슈를 작업 중이거나 PR을 제출하셨다면 GitHub를 통해 계속 소통하실 수 있습니다. 다른 질문이 있거나 실시간 도움이 필요하시다면 BeeWare Discord 서버에서 저희를 찾으실 수 있습니다. 앞으로도 함께 작업할 수 있기를 기대하겠습니다!
이 가이드 개선하기¶
이 스프린트 가이드를 개선할 방법에 대한 제안이 있으면 알려주세요. 어떤 점이 도움이 되었나요? 어떤 점이 도움이 되지 않았나요? 무엇을 개선하면 좋을까요? 그리고 기억하세요. 문제를 해결하면 BeeWare에 기여한 것으로 간주됩니다!