버그 다루기
***********

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

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


설명서 버그
===========

이 설명서에서 버그를 발견하거나 개선 제안을 하고 싶다면, 버그 보고서를
추적기 에 등록해 주세요. 문제가 한국어 번역에만 존재한다면,
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 는 파이썬에서 문제를 수정하는 과정에 관한 모든
질문에 대한 답변을 얻을 수 있는 친근한 곳입니다.
