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

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

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


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

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

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 bug
tracker.

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

더 보기:

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

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

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

  설명서 번역
     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 는 파이썬에서 문제를 수정하는 과정에 관한 모든
질문에 대한 답변을 얻을 수 있는 친근한 곳입니다.
