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

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

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


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

If you find a bug in this documentation or would like to propose an
improvement, please submit a bug report on the issue tracker.  If you
have a suggestion on how to fix it, include that as well.

If the bug or suggested improvement concerns the translation of this
documentation, submit the report to the translation’s repository
instead.

You can also open a discussion item on our Documentation Discourse
forum.

If you find a bug in the theme (HTML / CSS / JavaScript) of the
documentation, please submit a bug report on the python-doc-theme
issue tracker.

더 보기:

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

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

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

  설명서 번역
     A list of GitHub pages for documentation translation and their
     primary contacts.


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

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

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

보고하는 문제가 아직 목록에 없다면, GitHub 에 로그인해야 합니다. 아직
GitHub 계정이 없다면, "Sign up" 링크를 사용하여 계정을 만듭니다. 익명
으로 버그 보고서를 제출할 수는 없습니다.

지금 로그인되어있다면, 문제를 제출할 수 있습니다. 상단 바에서 "New
issue" 버튼을 클릭하여 새 문제를 보고해주세요.

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

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

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

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

더 보기:

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

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


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

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