# 버그 다루기

파이썬은 안정성에 대해 명성을 쌓아온 성숙한 프로그래밍 언어입니다. 이 평판을 유지하기 위해, 개발자는 파이썬에서 여러분이 발견한 결함을 알고 싶어 합니다.

때로는 버그를 직접 수정하고 패치를 파이썬에 제공하는 것이 프로세스를 간소화하고 인력을 덜 요구하기 때문에 더 빠를 수 있습니다. 이바지하는 방법을 배우세요.

## 설명서 버그

이 설명서에서 버그를 발견하거나 개선 제안을 하고 싶다면, 버그 보고서를 추적기 에 등록해 주세요. 문제가 한국어 번역에만 존재한다면, https://github.com/python/python-docs-ko/issues 에 등록해야 합니다. 수정하는 방법에 대한 제안이 있다면, 포함 시켜 주세요.

시간이 부족하다면, 설명서 버그 보고서를 docs@python.org 로 전자 메일로 보낼 수도 있습니다 (동작 버그는 python-list@python.org 로 보낼 수 있습니다). 〈docs@〉 는 자원 봉사자가 운영하는 메일링리스트입니다; 처리되는 데 다소 시간이 걸릴 수 있지만, 여러분의 요청에 대한 통지가 있을 것입니다.

더 보기

설명서 버그

  파이썬 문제 추적기에 제출된 설명서 버그 목록.

이슈 추적

  추적기에 개선을 보고하는 것과 관련된 절차 개요.

설명서에 도움 주기

  파이썬 설명서에 기여하는 데 관심이 있는 개인을 위한 종합 지침서.

## 파이썬 문제 추적기 사용하기

파이썬 자체의 버그 보고서는 파이썬 버그 추적기(https://bugs.python.org/)에 제출해야 합니다. 버그 추적기는 관련 정보를 입력하여 개발자에게 제출할 수 있는 웹 양식을 제공합니다.

보고서를 작성하는 첫 번째 단계는 문제가 이미 보고되었는지를 확인하는 것입니다. 개발자가 시간을 절약하는 것 외에도, 이렇게 하는 것의 이점은 문제를 해결하기 위해 수행된 작업을 배우게 되는 것입니다. 다음 배포에 포함될 이미 해결된 문제이거나, 추가 정보가 필요할 수 있습니다 (이 경우 가능하다면 직접 제공하는 것을 환영합니다!). 이렇게 하려면, 페이지 상단의 검색 상자를 사용하여 버그 데이터베이스를 검색해야 합니다.

보고하는 문제가 아직 버그 추적기에 없다면, 파이썬 버그 추적기로 돌아가서 로그인해야 합니다. 아직 추적기 계정이 없다면, 《Register》 링크나 (OpenID를 사용하는 경우) 사이드바에 있는 OpenID 제공 업체 로고 중 하나를 선택합니다. 익명으로 버그 보고서를 제출할 수는 없습니다.

지금 로그인되어있다면, 버그를 제출할 수 있습니다. 사이드바에서 《Create New》 링크를 선택하여 버그 보고 양식을 열어주세요.

제출 양식에는 여러 필드가 있습니다. 《Title》 입력란에 문제의 아주 짧은 설명을 입력합니다; 10단어 미만이 좋습니다. 《Type》 입력란에서 문제 유형을 선택합니다; 또한 버그가 관련된 《Component》 및 《Versions》도 선택합니다.

《Comment》 입력란에, 문제를 자세히 설명하는데, 기대한 것과 실제로 일어난 것을 포함합니다. 확장 모듈이 개입하고 있는지, 그리고 사용 중인 하드웨어 및 소프트웨어 플랫폼 (적절한 버전 정보 포함)을 포함해야 합니다.

각 버그 보고서는 문제를 해결하기 위해 수행해야 할 작업을 결정하는 개발자에게 할당됩니다. 여러분은 버그에 액션이 있을 때마다 업데이트를 받게 됩니다.

더 보기

버그를 효과적으로 보고하는 방법

  유용한 버그 보고서를 작성하는 방법에 대해 자세히 설명하는 기사. 이것은 어떤 종류의 정보가 유용하고 왜 유용한지를 설명합니다.

버그 보고서 작성 지침

  좋은 버그 리포트 작성에 관한 정보. 이 중 일부는 모질라(Mozilla) 프로젝트에만 적용되지만, 일반적인 우수 사례를 설명합니다.

## 파이썬에 직접 이바지하기 입문

발견한 버그를 보고하는 것 외에도, 패치를 제출하여 문제를 해결할 수 있습니다. 파이썬을 패치하는 방법에 대한 더 많은 정보는 Python Developer’s Guide 에서 찾을 수 있습니다. 질문이 있으면, core-mentorship mailing list 는 파이썬에서 문제를 수정하는 과정에 관한 모든 질문에 대한 답변을 얻을 수 있는 친근한 곳입니다.