기여자 풀 리퀘스트 가이드

Exercism에 기여하고 싶으시다니 감사해요! 풀 리퀘스트를 만들기 전에, 좋은 풀 리퀘스트 만드는 방법 가이드를 먼저 읽어보세요. 이 가이드는 풀 리퀘스트의 비기술적인 부분을 도와줘서, 좋은 경험을 하고 동시에 메인테이너 팀도 도울 수 있게 해줘요.

이 문서에는 여러 유형의 풀 리퀘스트를 위한 Exercism만의 추가 지침이 담겨 있어요.

연습 문제 풀 리퀘스트

개념 연습 문제나 실습 문제를 위한 풀 리퀘스트를 만드는 일은, 이런 유형의 연습 문제에 적용되는 규칙이 많아서 부담스러울 수 있어요. 그래서 메인테이너 한 명이 검토하는 데 두세 시간이 걸리고, 수십 개의 댓글이 달리기도 해요. 도움을 드리기 위해, 한 명의 주 검토자가 풀 리퀘스트에 댓글을 남겨줄 거예요.

검토 댓글이 많다고 낙담하지 마세요. 연습 문제가 여러 번 고쳐 쓴 끝에 여러분과 주 검토자 모두 만족하는 결과에 도달하는 건 아주 정상이에요.

권장 사항

프로세스를 더 원활하게 만들기 위한 몇 가지 권장 사항을 소개해요.

문서를 읽어보세요

연습 문제를 위한 풀 리퀘스트를 만들기 전에, 개념 연습 문제 문서와 실습 문제 문서를 꼭 읽어보세요. 미리 문서를 읽어두면 정말 큰 도움이 돼요. 검토할 때 댓글이 줄어들고, 풀 리퀘스트가 훨씬 빨리 병합되거든요.

기존 연습 문제 살펴보기 (있는 경우)

트랙에 이미 있는 연습 문제가 있다면, 시간을 내서 어떻게 생겼고 어떻게 구성되어 있는지 조금 살펴보세요.

실습 문제 풀 리퀘스트

변경 사항이 정말 problems-specifications에 속하는지 생각해보기

실습 문제의 일부 내용(예: 소개)은 problems-specifications 저장소에 정의된 (공유) 메타데이터에서 가져와요. 그런 내용을 업데이트하려고 한다면, 그 변경이 다른 트랙에도 도움이 될지 생각해보세요. 그렇다면 대신 problems-specifications 저장소의 해당 연습 문제 메타데이터에 풀 리퀘스트를 열어주세요.

일반적인 권장 사항

요청받지 않은 검토는 하지 않기

모든 풀 리퀘스트 검토는 트랙의 메인테이너 한 명(또는 여러 명)이 해요. 저장소의 모든 변경을 최종 승인하는 책임이 메인테이너에게 있기 때문이에요. 메인테이너가 직접 검토하면, 풀 리퀘스트 작성자가 서로 충돌하는 피드백을 받는 일도 피할 수 있어요.

물론 검토를 돕기 위해 댓글을 남기거나(특히 큰 풀 리퀘스트라면), 실수로 보이는 부분을 발견했을 때 질문을 남기는 건 얼마든지 환영해요.