Electron 이슈 처리 가이드
이슈에 기여하는 방법
어떤 이슈든 개인이 기여할 수 있는 기본적인 방법은 세 가지가 있다:
- 이슈를 열어 토론 시작하기: Electron에서 새로운 버그를 발견했다고 생각한다면,
electron/electron이슈 트래커에 새 이슈를 생성해 보고한다. - 이슈 분류에 도움 주기: 버그를 재현할 수 있는 테스트 케이스를 제공하거나, 이슈를 해결할 수 있는 제안을 함으로써 도움을 줄 수 있다.
- 이슈 해결에 기여하기: 해당 이슈가 버그가 아니거나 이미 수정되었음을 증명하거나, 더 일반적으로는
electron/electron소스 코드를 구체적이고 검토 가능한 방식으로 변경하는 풀 리퀘스트를 열어 해결할 수 있다.
일반적인 도움 요청하기
Electron 웹사이트에서는 프로그래밍 도움을 얻거나 보안 문제를 보고하고, 기여하는 방법 등 다양한 리소스를 제공한다. 버그와 관련된 문제는 이슈 트래커를 사용해야 한다!
버그 리포트 제출 방법
버그 리포트를 제출하려면:
electron/electron 이슈 트래커에서 새 이슈를 열 때, 사용자에게 작성해야 하는 템플릿이 표시된다.
Electron에서 버그를 발견했다고 생각되면, 가능한 한 상세히 템플릿을 작성한다.
버그 리포트를 평가하는 데 가장 중요한 두 가지 정보는 버그에 대한 설명과 이를 재현할 수 있는 간단한 테스트 케이스다. 버그를 재현할 수 있으면 수정하기가 더 쉽다.
최소한의 완전하고 검증 가능한 예제를 만드는 방법을 참고한다.
버그 리포트 분류하기
오픈 이슈에는 토론이 필수적으로 수반된다. 기여자들 사이에서 특정 동작이 버그인지 아니면 기능인지에 대해 의견이 엇갈리는 경우도 있다. 이러한 토론은 프로세스의 일부이며, 논의는 항상 집중적이고 도움이 되며 전문적으로 진행해야 한다.
추가적인 맥락이나 근거를 제공하지 않는 짧은 답변은 도움이 되지 않을 뿐만 아니라 전문적이지 않다. 많은 사람에게 이런 답변은 불쾌하고 불친절하게 느껴진다.
기여자들은 협력적으로 문제를 해결하고 서로 발전할 수 있도록 도와야 한다. 만약 유효하지 않다고 생각되는 이슈를 발견했거나 잘못된 정보가 포함된 경우, 왜 그렇게 생각하는지 추가적인 맥락과 근거를 제시하면서 설명해야 한다. 또한 자신이 틀릴 수도 있다는 가능성에 열려 있어야 한다. 이렇게 하면 올바른 결론에 더 빨리 도달할 수 있다.
버그 리포트 해결 과정
대부분의 이슈는 풀 리퀘스트를 열어 해결한다. 풀 리퀘스트를 열고 리뷰하는 과정은 이슈를 열고 분류하는 과정과 유사하지만, 제안된 변경 사항이 Electron 프로젝트의 최소 품질 및 기능 가이드라인을 충족하는지 확인하기 위한 리뷰와 승인 워크플로가 포함된다.