도움말:이슈 트래커/old

2015년 8월 2일부터 리브레 위키에 이슈트래커가 새로 개설되었습니다! 개발진과의 소통을 좀 더 용이하게 하기 위해서인데요, 이슈트래커를 사용하면 더욱 쉽게 문제 해결 담당자, 문제 해결 현황 등을 확인할 수 있어 편리합니다. 하지만 아직 이슈트래커에 익숙하지 않은 분들이 많습니다. 문제를 발견했는데 이슈트래커를 어떻게 사용할지 몰라서 헤매고 계신다면, 이 문서를 읽어주세요. 이슈트래커 사용, 어렵지 않습니다!

1 사용에 앞서[편집]

문제를 발견하셨지만, 개발진만 해결할 수 있는 문제인지, 운영진 내에서 해결 가능한 문제인지 확신이 서지 않는 상황인가요? 먼저 리:기술지원방에 문의하세요. 운영진이 요청을 검토하고 운영진 차원에서 해결 가능한 문제라면 곧 해결해 드릴겁니다. 개발진 개입이 필요한 상황이라면 운영자가 이슈 트래커로 유도해 드릴거예요. 급한 문제라거나, 비로그인 사용자라면 운영진이 대신 이슈트래커에 올려드릴 수도 있습니다.

이제 리브레 위키의 이슈트래커 사용법을 알아봅시다.

2 회원 가입하기[편집]

문제 제보를 하려면 이슈트래커에 회원 가입을 해야 합니다. 아쉽게도 리브레 위키의 계정과의 연동은 개발 중에 있습니다. 지금으로서는 따로 계정을 만드셔야 해요. 주소창에 issue.librewiki.net을 치시면 이슈트래커로 이동합니다. 아래 사진에서 빨갛게 표시된 버튼을 누르세요.

Phab00.PNG

그러면 다음과 같은 화면이 뜰 거예요. 깃허브 계정이 있다면 OAuth를 통해 로그인하실 수 있습니다. 깃허브 계정으로 로그인하실 분들은 아래의 계정 등록 절차를 건너뛰세요. 아래에는 보통의 방법으로 계정을 등록하는 방법을 다룹니다. 먼저 register new account 버튼을 눌러주세요.

Phab02.PNG

이 화면에서 입력하라고 하는 정보는 모두 필수 사항입니다. 모두 기입해주세요.

Phab03.PNG


모든 정보를 입력하셨다면 register account 버튼을 눌러 회원 가입 절차를 마쳐주세요. 그러면 자동으로 로그인이 됩니다. 자, 이제 문제를 제보해봅시다!

3 문제 제보하기[편집]

Phab01.PNG

저 화면 오른쪽 상단의 더하기 버튼을 눌러주세요! 그럼 아래와 같은 드롭다운 메뉴가 뜹니다. 빨간색으로 표시한 maniphest task를 클릭해주세요!

Phab04.PNG


이제 문제가 무엇인지 구체적으로 작성할 차례입니다. 아래와 같은 화면이 보이실 거예요. 각 란이 어떤 의미를 가지는지 하나하나 설명해보도록 하겠습니다.

Phab05.PNG

3.1 제목 (Title)[편집]

제목란을 모르시지는 않겠죠? 그 문제의 핵심이 무엇인지 한 줄로 요약해서 적어주세요.

3.2 cc[편집]

이메일에서 cc 개념과 유사합니다. cc로 누군가를 올리면 그 사람은 자동으로 그 문제에 구독하게 돼요. 이 문제에 활동이 있다면 알림을 받게 되는 겁니다. 혹시 특정 개발자가 이 문제를 해결할 수 있을 것 같다! 혹은 이 개발자만 그 권한을 가지고 있다!라는 것을 아신다면 사용하시면 좋을 거예요. 그 개발자에게 바로 알림이 가니까요.

3.3 중요도 (priority)[편집]

그 문제가 얼마나 시급하고 중대한지에 따라 중요도가 나뉩니다. 이는 개발자가 문제를 해결할 때 급한 것부터 해결해나갈 수 있도록 하기 위해서입니다. 중요도는 6개 중 하나를 선택할 수 있습니다.

  • Unbreak Now! (당장 고쳐!): 심각한 문제가 발생하였으며, 다른 일 다 제쳐두고 해결해야 합니다.
  • Need Triage(우선순위 미설정): 개발자가 중요도를 결정하게 합니다. 기본값입니다.
  • High (높음): 중대한 문제로, 가능한 빨리 수정해야 합니다. 누군가가 작업하기로 되어 있습니다.
  • Normal (보통): 심각한 문제는 아니지만, 수정이 예정되어 있습니다.
  • Low (낮음): 사소한 문제로, 급히 해결해야 할 필요가 없습니다.
  • Wishlist (위시리스트): 지금은 조치를 취하지 않지만, 나중에 시간 날 때 천천히 구현하면 좋겠다라는 의미입니다.

2015년 11월 2일 현재, 일반 사용자는 우선순위를 설정할 수 없어요. 여러분이 발견한 문제가 모두 빨리 해결되었으면 좋겠지만, 한정된 인력으로 리브레 위키 개발 업무를 보는 개발진의 상황 상 모든 문제를 당장 해결해 드릴 수는 없어요.

3.4 프로젝트 (projects)[편집]

어느 분야의 문제인지를 결정하는 란입니다. 현재 리브레 위키 파브리케이터에는 총 아홉 개의 프로젝트가 생성되어 있습니다. 이 중 일반 사용자가 사용하게 되는 프로젝트는 게시판, 리브레 맵스, 리브레엔진, 미디어위키, 소도구, 파브리케이터, 합의 필요, 보안 여섯 개입니다. 게시판 관련 버그는 게시판 프로젝트를, 리브레 엔진 관련 건의사항 등은 리브레엔진 프로젝트를, 현재 리브레 위키에서 문제가 있다면 미디어위키 프로젝트를, 공식 소도구들에서 문제가 발생했다면 소도구 프로젝트를, 이슈 트래커에 문제가 있다면 파브리케이터 프로젝트를 선택해주시면 됩니다. 합의 필요는 위키 내에서 좀 더 많은 논의가 필요하다고 판단되는 경우 사용합니다. 리브레 맵스 프로젝트는 리브레 맵스 사용 중에 발견한 문제를 제보할 때 사용하겠죠? 보안 프로젝트는 리브레 위키에서 보안 취약점을 발견하셨을 경우 사용하시면 됩니다.

선택하시는 방법은 굉장히 간단합니다. 프로젝트 란에서 원하는 프로젝트 이름을 치기 시작하면 아래로 이름이 일치하는 프로젝트들이 나열됩니다. 그 중 원하는 프로젝트를 선택해주시면 됩니다. 참고로, cc 란에 프로젝트를 삽입하지 마세요!


3.5 내용 (Description)[편집]

어떤 문제인지 구체적으로 설명하는 칸이겠지요? 어떤 문제가 있고, 자신은 어떤 컴퓨터 환경에서 작업하고 있으며, 어떤 상황에서 그 문제가 발생한다 등을 최대한 구체적으로 적어주세요. 그래야 개발자들이 문제를 해결하기도 쉬워집니다.

여기에서 위키문법과 유사한 마크업 언어를 사용하실 수 있습니다. 영어로 된 도움말은 여기에 있습니다. 하지만 대개의 경우 문법을 사용하지 않으셔도 문제 제보를 하는 데에는 큰 문제는 없을 겁니다.


다 작성하셨다면 Create Task 버튼을 클릭해주세요! 문제가 제보되었습니다!

4 문제 해결 현황 확인하기[편집]

문제를 제보하셨다면, 이제 그 문제가 어떻게 해결되는지 확인해야겠지요? 우선 여러분이 방금 생성하신 문제 제보를 태스크 (일감) 이라고 부릅니다. 그 태스크에 어떤 변화가 있다면 여러분에게 알림이 뜰 거예요. 하지만 막상 태스크 페이지로 이동했는데 그 페이지에 적혀있는 정보가 어떤 의미인지 이해하지 못한다면 아무런 소용이 없겠죠? 여기에서는 태스크 페이지에서 사용되는 단어를 간단히 정리해보려고 합니다.

Phab06.PNG

먼저 subscriber이 추가되었다는 것은, 그 태스크를 구독하는 사람이 추가되었다는 의미입니다. 즉 여러분처럼 그 태스크에 관심을 가지고, 변화가 있다면 알림을 받고 싶어하는 사람이 더 있다는 뜻입니다.

assigned to는 그 문제를 맡을 개발자가 정해졌다는 의미입니다. 앞으로 그 문제에 대해서는 그 개발자가 총괄하여 여러분과 이야기하고, 문제를 해결해나갈 거예요.

claimed 는 그 개발자가 자발적으로 그 문제를 해결하겠다고 나섰다는 의미입니다. 결과는 assigned to와 같겠죠?

triaged 는 중요도 설정이 이루어졌다는 의미입니다. 개발자가 그 문제를 확인하고 그 중요도를 판단했다는 의미에요.

그 다음 덧글 기능이 있습니다. comments라고 하죠. 이는 사람들이 정보를 추가하거나, 그 문제에 대해 대화할 때 사용되는 기능입니다. 너무 당연한걸 설명한다고요? 죄송합니다 흑흑...

closed는 그 태스크를 닫는다는 뜻입니다. 이 때 설정 가능한 문제의 상태는 resolved, declined, invalid, spite가 있습니다. resolved는 문제가 해결되었다는 의미이며, declined는 그 문제는 해결하지 않겠다, 혹은 해결할 방법이 없다라는 의미로 받아들이시면 됩니다. invalid는 버그가 아닌 요청에 대해 사용하며, spite는 장난, 스팸 등에 사용합니다.