이 페이지는 Cloud Translation API를 통해 번역되었습니다.

프로젝트에 적합한 측정항목 선택

이 가이드는 조직이 더 나은 문서화로 해결할 수 있는 문제 종류와 문서 프로젝트에 적절한 측정항목을 선택하는 방법을 이해할 수 있도록 돕기 위해 작성되었습니다.

현재 단계:
문서 개발 타임라인을 참고하세요.

문제 설명

측정항목을 선택하기 전에 해결하려는 문제를 잘 이해하고 있어야 합니다. 최대한 구체적으로 답해 주세요.

원인과 결과를 찾아냅니다. 알려주신 문제의 원인이 무엇인가? 문제의 원인이 여러 개이거나 중복될 수 있습니다.

"스타일에 관한 명확한 지침이 없기 때문에 온보딩 문서의 pull 요청을 병합하는 데 시간이 너무 오래 걸립니다. 검토자는 무엇을 해야 할지 모르기 때문에 PR 검토를 미루거나 형식 지정에 관해 도움을 주신 분들과 의견을 주고받습니다."
'사용자가 문서에서 오류 코드에 관한 정보를 찾을 수 없으므로 문제를 열어야 합니다.'
제공업체의 계획 한도 및 시간 초과 때문에 CI/CD 테스트가 실패합니다.
"회의가 현지 시간대로 오전 5시 30분에 시작해서 주간 회의에 사람들이 불평합니다."

새롭거나 더 나은 문서로 해결할 수 있는 문제인가요?

"스타일 가이드가 있으면 커밋한 사용자가 PR을 제출하기 전에 가이드를 확인할 수 있습니다. 검토자는 무엇을 확인해야 하는지 알 것입니다. 검토자와 기여자는 형식, 어조, 스타일에 대해 논쟁할 필요가 없었을 것입니다."
"오류 코드 문서가 있으면 사용자가 문제를 여는 대신 여기에서 답을 찾을 수 있습니다."
"음, 더 나은 문서화는 CI/CD 문제를 해결할 것 같지 않습니다."
"각 회의를 시작할 때 농담을 하며 시작할 수 있었습니다. 유머를 모아놓고 웃으면서 회의를 시작하는 데 도움이 될 것 같습니다."

문제를 수치화할 수 있나요?

"'PR을 병합하는 데 시간이 너무 오래 걸림'이란 무엇을 의미하나요? 두 달? 2주? 도움을 주신 분들은 검토를 포기할 때까지 얼마나 기다려야 하나요?"
"몇 개의 오류 코드 관련 문제가 '너무 많은 문제'인가요?"
"음... 얼마나 심술궂은지?"

제안된 측정항목을 확인하려면 어떻게 해야 하나요? 쉽고 정확하게 측정할 수 있는가? 누가 측정하는지에 따라 측정값이 달라지나요?

"pull 요청이 열린 시간과 검토가 요청된 후 경과한 시간을 쉽게 측정할 수 있습니다. 도움을 주신 분들이 언제 포기하는지 정확히 가늠할 수는 없습니다."
"'error-code'로 태그가 지정된 문제 수를 세거나 문제 내에서 오류 코드 텍스트를 검색할 수 있습니다."
"사람들의 불만스러움을 재치 있게 또는 정확하게 측정할 수는 없어요."

문서로 문제가 해결되는지 여부를 파악하는 데 도움이 되는 다른 측정항목이 있나요? 목표 측정항목은 모든 경우에 동일한가요?

"PR이 길어질수록 검토하는 데 시간이 더 오래 걸립니다. 다양한 PR 크기에 따라 기준점이 달라야 합니다. 소형, 중형, 대형, 대규모 PR의 병합 시간을 측정하려고 합니다."
"오류 코드 문서에서 방문수를 확인하고 해당 횟수가 미해결 문제 수와 관련이 있는지 확인할 수 있었습니다."

"중소 규모의 PR을 병합하는 데는 2주가 적절한 시간이라고 생각하며 모든 PR을 한 달 내에 병합해야 합니다. 2주마다 측정하겠습니다."
"오류 코드 관련 문제의 수를 매일 업데이트하는 것은 말이 되지 않습니다. 문제를 해결하는 데 일반적으로 1주일이 소요되기 때문입니다. 매주 측정하겠습니다."

프로젝트가 성공했음을 나타내려면 선택한 측정항목에서 얼마나 많은 변화를 확인해야 할까요? 선택한 측정항목의 양적 목표를 설정해 보세요.

"새로운 PR을 한 달 이내에 모두 종료한다는 목표를 달성했다면 성공할 것입니다. 대규모 PR을 종료하는 데 걸리는 평균 시간이 2주 단축되면 큰 성공이 될 것입니다."
"이상적으로는 새로운 오류 관련 문제가 발생하지 않습니다. 하지만 오류 관련 문제가 50% 감소하면 프로젝트가 성공했다고 간주할 수 있습니다."