# 버그 다루기

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

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

## 설명서 버그

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