버그를 보고하는 방법

This page is a translated version of the page How to report a bug and the translation is 100% complete.
Phabricator is for software bug reports, feature requests, and planning work.
  • To ask technical questions about Wikimedia projects, see m:Tech
  • To ask technical questions about MediaWiki in non-WMF installations, see Project:Support desk

이 지침은 위키미디어 버그트래커에서 버그 보고 및 기능 요청을 하는 방법을 설명합니다. (자세한 사항은 파브리케이터 를 참고하세요.) 버그 보고를 잘 작성할수록 작업이 진행될 가능성이 높아집니다. 버그 보고는 영어로 써야 합니다. 만약 당신이 영어를 못 한다면 구글 번역기와 같은 기계 번역을 써 보세요.

권장 사항

  • 정확히 작성하세요
  • 명확히 작성하세요: 1) 상황을 재현하는 방법을 혼란의 여지가 없도록 단계별으로, 2) 원래 발생했어야 할 상황이 무엇인지, 3) 현재 발생하고 있는 상황은 무엇인지, 문단을 구분하여 설명해 주세요.
  • 태스크당 하나의 구체적인 문제점이나 구체적인 기능 요청만 설명하세요
  • 관련된 링크와 예시를 필히 첨부하세요

시작하기 전에 확인할 것

버그를 해결할 수 있나요?

미디어위키 최신 버전을 이용해 버그를 해결하려고 시도해 보세요. 버그가 이미 수정되었을 수 있습니다. 만약 위키백과 같은 사이트에 버그가 있다면, test2.wikipedia.org 같은 최신 버전 테스트 공간에서 버그를 테스트해 보세요.

이미 다른 사람이 문제를 보고했나요?

버그가 이미 보고되었는지, 기능이 요청되었는지 확인하려면 위키미디어의 버그트래커의 검색 상자를 사용하십시오. 고급 검색 페이지에서 고급 검색을 수행할 수도 있습니다.

버그가 이미 보고되었는지 확실치 않다면 버그를 보고하는 것이 좋습니다. 버그가 보고되지 않는 것보다 버그를 중복 보고하는 편이 더 낫습니다.

혹시 소도구 / 사용자 스크립트 문제는 아닌가요?

일부 문제는 일부 수정이 필요한 사용자 스크립트와 소도구를 사용함으로써 발생합니다. 이러한 코드를 식별하는 방법에 관해 단계별로 설명된 안내서 가 있으며 보고에 시간을 낭비하지 않도록 문제를 해결할 수 있습니다.

캐시 문제인가요?

일부 문제는 오래된 캐시된 HTML이 새로운 JavaScript와 함께 제공되어 둘이 호환되지 않을 때 발생합니다. 원인이 이것인지 확인하려면 페이지를 정리하고 페이지를 새로고침하여 문제가 계속 발생하는지 확인하고 이 정보를 버그 보고서에 포함하는 것이 좋습니다.

새 버그를 보고하거나 기능을 요청하기

만약 최신 버전에서 버그를 발견했고 아무도 보고한 것 같지 않을 때는,

  1. phabricator.wikimedia.org로 이동하십시오.
  2. 아직 로그인(또는 등록)하지 않았다면 로그인(또는 등록)을 해야 합니다. ("계정 만들기 " 참고)
  3. 상단 오른쪽 모퉁이의 북마크 버튼을 클릭하고 "태스크 만들기"(보안 문제 보고 의 경우 "오류 보안 문제")를 클릭하십시오.
  4. 적어도 이 칸은 무조건 채워야 합니다:
    • 제목: 문제를 설명하는 짧은 한 문장의 요약 (해결책 제안이 아님)
      • 좋음: "Selecting gender is not functional on Special:Preferences"
      • 나쁨: "Software crashes"
    • 설명: 현재 갖고 있는 모든 정보를 제공하여 오류에 대해 최대한 자세히 설명하세요. 이것으로 충분하지 않다면 추가 정보를 요청받게 되며, 이를 얻는 방법에 대한 안내도 함께 제공될 것입니다. 이 칸은 다음을 포함해야 합니다:
      • 버그:
        • 재현 단계: 기술된 문제를 재현할 수 있는 따라가기 쉬운 최소한의 단계적 설명입니다. 모든 특수한 설저어 단계를 포함시키십시오.
          예시:
          1. Go to https://en.wikipedia.org with Internet Explorer version 10.0;
          2. Make sure you are logged in;
          3. Select "My Preferences" menu;
          4. Go to "Gender" and select female gender from box list;
          5. Click "Save" button.
        • 실제 결과: 이 단계들을 수행한 이후 응용 프로그램이 한 행위.
          예시:
          "There is no female gender in front of my username."
        • 기대되는 결과: 응용 프로그램에 버그가 없을 경우 발생하는 일.
          예시:
          "My gender is shown in front of my username."
      • 기능 요청:
        • 성취하고 싶은 바에 관한 설명 및 그 이유입니다. 특정한 예시를 곁들여, 해당 기능이 해결해주길 바라는 바(실제 기반이 되는 문제)를 설명하세요. 그러나 다른/더 나은 해결책이 있을 수 있으므로 특정한 해결책을 요구하지 마십시오. 사용자 이야기는 이를 전달하는 효과적인 방법입니다.
          예시:
          "As a new editor, I would like to be acknowledged for my contribution to the project, so that I feel welcomed and valued"
      • 다음과 같은 유용한 다른 정보들도 주시기 바랍니다.
        • 버그가 발생한 웹 브라우저, 스킨 또는 컴퓨터 시스템
        • 오류가 발생한 하나 이상의 문서의 링크나 diff
        • 문제가 항상 일어나는지, 가끔, 혹은 특정 페이지나 특정한 환경에서만 발생하는지의 여부.
    • 로그 파일 또는 스크린샷 (기밀 데이터는 포함되거나 표시되어서는 안 됩니다)을 첨부하려면 설명 칸의 도구 표시줄에 있는 파일 업로드 버튼(화살표가 있는 구름)을 클릭하십시오.
    • 버그를 찾은 태그(프로젝트)를 선택하십시오:
      • 프로젝트는 개발자가 작업할 태스크를 찾는 방식입니다. 올바른 프로젝트를 식별하려면 (오른쪽 상단의) 검색 기능을 사용하여 그에 관한 설명을 검색하십시오.
      • 미디어위키 자체의 문제는 MediaWiki-General 가 될 것이고, 위키미디어 위키 사이트의 설정 변경은 Wikimedia-Site-Requests 이 될 것입니다 (Selecting projects 을 참고하세요).
    • 구독자: 이 태스크의 알림에 관심이 있는 특정 사용자를 알고 있다면 여기에 추가할 수 있습니다. 그러한 경우가 아니라면 이 칸을 무시하십시오.

보고서가 완성되었는지 확인한 다음 "태스크 만들기" 버튼을 누르십시오. 보고서는 이제 데이터베이스에 위치하게 됩니다. 이 보고서에 관심을 가진 누군가가 이를 살펴보고 작업에 착수 할 수 있습니다.

태스크의 우선순위는 태스크에 작업을 착수할 계획이 있으면 개발자가 선정합니다. (우선순위 설정 참고)

이게 다입니다! 미디어위키 및 위키미디어 프로젝트 개선을 도와주셔서 감사합니다!

자바스크립트 버그 보고하기

같이 보기: Help:Locating broken scripts

소도구, 사용자 스크립트나 미디어위키의 일부분과 같은 많은 기능이 자바스크립트에 의존합니다.

자바스크립트와 관련될 수 있는 버그를 발견한다면 최대한 오류 메시지를 식별한 다음 버그 보고서에 이 내용을 복사하십시오.

시스템 관리자도 모든 오류 기록에 접근하지는 못하기 때문에 갖고 계신 모든 정보를 제공하는 것이 특히 중요합니다.

문제가 사용자 스크립트의 코드나 소도구 자체에 있는 경우 파브리케이터는 문제 관리를 위한 적절한 장소가 아닐 수 있습니다.[1] 누군가가 스크립트의 토론 문서로 안내할 수 있습니다. (문제가 되는 스크립트가 식별이 가능한 경우)

연결 오류 보고하기

위키미디어 웹사이트 접근에 어려움이 있다면(느린 인터넷 접속 등) https://wikitech-static.wikimedia.org/wiki/Reporting_a_connectivity_issue를 읽어 주십시오.

로그인 문제 보고하기

계정에 로그인하는 데 문제가 있으면 Manual:How to debug/Login problems 을 따라주세요.

각주

같이 보기