# 따라 할 수 있는 가이드 검수표
회몬 · JH Soft Labs | 공개용 v1.0 | 2026-09-13
관련 기록: https://jhsoftlabs.com/stories/guides-that-work.html

작업 기록을 바탕으로 새로 만든 공개용 검수 양식입니다.
개인·팀 작업에 맞게 복사해 채워 쓰세요. 검색 노출이나 순위를 보장하지 않습니다.

## 사용 순서
1. 독자의 증상과 원하는 결과를 한 문장으로 적습니다.
2. 같은 입력으로 문제와 해결 결과가 재현되는지 확인합니다.
3. 원고·예제·공개·검색 확인 상태를 따로 기록합니다.

## 1. 독자가 하려는 일
- 글 제목 / 대상 독자:
- 독자가 겪는 증상:
- 원하는 결과:
- 이 글에서 다루지 않는 경우:
- 비슷한 제목의 다른 글과 다른 행동:
- 사용하는 프로그램 / 버전 / 언어·지역 설정:
- 실제 확인일:
- 확인한 공식 문서 URL:

## 2. 먼저 적는 예상 결과
- 합성 입력 데이터 / 파일:
- 입력에 이 문제를 보여주는 요소가 있는가:
- 실행할 정확한 단계 또는 명령:
- 실행 전 예상 결과:
- 실행 후 실제 결과:
- 예상과 다른 부분 / 수정 사항:
- 빈 값, 0, 식별자, 날짜 등 의미가 달라질 수 있는 값:
- 저장한 결과를 다시 읽어 확인할 방법:
- 검증하지 못한 환경과 이유:

## 3. 샘플과 설명 점검
- [ ] 입력만 보고도 어떤 문제가 있는지 확인할 수 있다.
- [ ] 입력 파일과 절차와 결과가 서로 일치한다.
- [ ] 실행 가능한 코드는 실제로 실행했다.
- [ ] 저장·변환 예제는 출력 파일을 다시 확인했다.
- [ ] 원본을 복사하고 복사본으로 시도하도록 안내했다.
- [ ] 빈 값과 0, 숫자와 식별자를 같은 것으로 설명하지 않았다.
- [ ] 모호한 날짜나 지역 설정의 전제를 명시했다.
- [ ] 합성 데이터만 쓰고 고객 원본을 샘플에 넣지 않았다.
- [ ] 도해가 실제 프로그램 화면인지 설명용 그림인지 구분했다.
- [ ] 맞지 않는 경우와 다음 확인 방법도 적었다.

## 4. 공개 점검
- [ ] 모바일에서 비교표·도해·코드가 잘리지 않는다.
- [ ] 샘플은 실제로 내려받을 수 있다.
- [ ] 여러 파일이 필요하면 파일별로 구분해 제공한다.
- [ ] 관련 글과 공식 문서 링크가 올바르게 열린다.
- [ ] 제목·설명·대표 주소가 실제 글의 내용과 일치한다.
- [ ] 공개된 페이지에서 마지막으로 절차를 확인했다.
- 공개 URL / 공개일:
- 마지막 내용 수정일 / 변경 이유:
- 아직 실패하는 항목:

## 5. 공개 이후의 관찰
모르는 값은 0이 아니라 '미확인'으로 적습니다.
- 관찰 기간 / 데이터 출처:
- 색인 상태 / 확인일:
- 노출 / 클릭: [미확인 또는 확인된 수치]
- 독자 피드백: [없음이라고 확인 / 미확인 / 확인된 내용]
- 공개 완료와 별개로 남은 작업:
- 다음에 고칠 한 가지:
- 다음 확인일:

## 가상 작성 예시
- 증상: 상품 코드 앞자리 0이 사라짐
- 합성 입력: 00123
- 원하는 결과: 식별자 문자열 00123 유지
- 핵심 확인: 숫자 계산을 위한 변환과 구분하기
- 공개 상태: 미게시
- 검색 상태: 미확인

샘플 검사 통과는 모든 환경의 정답을 뜻하지 않습니다.
확인한 환경과 한계를 글에도 함께 남기세요.