새로운 기여 가이드라인

자동으로 닫힌 Issue/PR에서 여기로 안내받았다면, 당황하지도, 거절당했다고 느끼지도 마세요. 대개의 경우 이미 해두신 작업은 결국 Exercism에 병합되거나, 겪고 있는 문제가 해결될 거예요. 저희는 기여를 환영하고 권장하지만, GitHub에서 코드를 작성하기 전에 포럼에서 먼저 이야기하는 걸 좋아해요. 포럼에 스레드를 열면 일이 앞으로 나아가요.

지난 한 해 동안 저희는 비메인테이너의 기여를 제한하는 실험을 해왔어요. 핵심 기여자들의 시간을 확보하고, 그들이 트랙에 더 의미 있는 개선을 할 수 있게 하기 위해서였죠. 이 방식은 꽤 잘 통했어요. 2022년과 비교하면, 2023년에는 새로 추가된 연습 문제가 두 배, 만들어진 실러버스가 세 배로 늘었어요. 이런 방법의 변화 덕분에 핵심 기여자들은 훨씬 더 큰 규모의 기여를 할 수 있게 되었고, 답답함과 방해 요소도 줄었어요.

하지만 도움을 주려는 새 기여자들이 저희 기여 절차 때문에 막혔다고 느끼며 답답해한다는 점도 알고 있어요. 그래서 오늘은 앞으로 몇 달 동안 기여를 어떻게 진행할지에 대한 새롭거나 더 명확해진 지침을 제안하려고 해요.

가장 먼저 이해해야 할 기본 규칙은 아이디어와 버그, 이슈는 포럼에서 논의하고, 그 결과로 생긴 코드 변경은 GitHub에서 (PR 리뷰에서) 논의한다는 거예요. 두 번째 규칙은 (자율적으로 움직이는 메인테이너를 제외하고는) 무엇이든 하기 전에 먼저 논의한다는 거예요. 저희 포럼에서는 여러 트랙의 기여자와 메인테이너가 GitHub에서 300개의 서로 다른 저장소를 구독해 알림에 파묻히지 않고도, 다양한 언어와 아이디어에 대한 지식과 지혜를 나눌 수 있어요.

업데이트된 지침

지원받기

• 연습 문제를 풀기 전에 하는 일에서 막혔다면 (예: CLI 설치, 테스트 실행, 연습 문제의 로직이나 요구 사항에서 막힌 경우), 포럼의 "Exercism Support" 카테고리와 Discord 서버의 #get-help 채널을 이용해요.
• 지원 요청은 GitHub나 이메일로 받지 않아요.
• 연습 문제를 풀었는데 궁금한 점이 있다면, Exercism에서 직접 멘토링을 요청해요.

버그와 이슈 보고하기

• 모든 버그와 이슈는 포럼에 올려요. 다양한 사람들이 문제를 이해하고 해결하는 데 도움을 줄 수 있어요.
  • 언어에 관한 문제라면 해당하는 Programming/xxx 카테고리를 이용해요.
  • 웹사이트의 버그라면 "Bugs & Feature Requests" 카테고리를 이용해요.
• GitHub 이슈는 대개 자동으로 닫히고, 작성자는 포럼으로 안내돼요 (지금처럼 클릭 한 번으로 자신의 이슈를 복사해 붙여넣을 수 있는 링크와 함께요).
• 트랙 메인테이너는 자동 이슈 닫기를 끌 수 있지만, 공식 경로는 여전히 포럼이에요.

Pull Request 열기

• Pull Request는 작업을 하기 전에 포럼에서 논의해요.
• 조직 구성원이 아닌 사람의 Pull Request는 계속 자동으로 닫히지만, 포럼에서 작업이 논의되면 자주 다시 열려요. PR의 아이디어가 이미 승인되었다면, 해당 포럼 스레드에 PR 링크만 추가해 주세요. 그러면 다시 열어드릴게요.
• 트랙 메인테이너는 자동 PR 닫기를 끌 수 있지만, 모든 PR은 먼저 포럼에서 논의하는 걸 권장해요.

요약

저희의 첫 번째 우선순위는 여전히 핵심 기여자들의 시간과 정신적 여유를 지키는 거예요. 이들이 없으면 Exercism은 운영될 수 없어요. 동시에 Exercism이, 새로운 사람들이 지나치게 높은 장벽 없이 참여할 수 있고, 저희가 그들을 격려하고 지원해 스스로 핵심 기여자가 될 수 있게 하는 곳으로 남길 바라요!

앞으로 몇 달 동안 이 변화가 기여에 어떤 영향을 미칠지 기대돼요. 2024년 중반에 다시 검토할 거예요.