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

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

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


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

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

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

더 보기:

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

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

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


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

Issue reports for Python itself should be submitted via the GitHub
issues tracker (https://github.com/python/cpython/issues). The GitHub
issues tracker offers a web form which allows pertinent information to
be entered and submitted to the developers.

The first step in filing a report is to determine whether the problem
has already been reported.  The advantage in doing so, aside from
saving the developers' time, is that you learn what has been done to
fix it; it may be that the problem has already been fixed for the next
release, or additional information is needed (in which case you are
welcome to provide it if you can!). To do this, search the tracker
using the search box at the top of the page.

If the problem you're reporting is not already in the list, log in to
GitHub. If you don't already have a GitHub account, create a new
account using the "Sign up" link. It is not possible to submit a bug
report anonymously.

Being now logged in, you can submit an issue. Click on the "New issue"
button in the top bar to report a new issue.

The submission form has two fields, "Title" and "Comment".

For the "Title" field, enter a *very* short description of the
problem; less than ten words is good.

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

Each issue report will be reviewed by a developer who will determine
what needs to be done to correct the problem. You will receive an
update each time an action is taken on the issue.

더 보기:

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

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


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

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