작성 원칙

좋아 보이는 말보다 검수 가능한 기준을 먼저 둡니다

이 문서는 detailry의 콘텐츠를 작성하고 수정할 때 적용할 기준을 설명합니다. 모든 글에서 각 항목의 검수가 완료됐다는 확인서나 과거 검사 결과는 아닙니다.

핵심 원칙

detailry의 콘텐츠는 디자인 취향을 강요하기보다 판단 기준을 남기는 것을 목표로 합니다. 같은 화면도 업종, 상품 가격, 구매 주기, 고객의 기대 수준에 따라 정답이 달라질 수 있기 때문에 글 안에서 가능한 한 맥락을 함께 설명합니다.

01경험과 정보 구분

직접 적용해 본 내용은 경험으로, 공개 자료에서 확인한 내용은 정보로 구분합니다.

02과장 표현 배제

전환율 보장, 매출 보장, 승인 보장처럼 결과를 확정하는 표현을 쓰지 않습니다.

03모바일 우선 검토

작은 화면을 고려할 때는 줄바꿈, 문장 길이, 버튼 위치를 확인 대상으로 삼습니다.

04한계 명시

사례가 제한적이거나 업종별 차이가 큰 내용은 일반화하지 않고 조건을 함께 적습니다.

출처와 검증

법규, 플랫폼 정책, 검색엔진 가이드, 광고 정책처럼 바뀔 수 있는 정보는 가능한 공식 문서를 먼저 확인합니다. 특정 툴이나 서비스의 기능을 설명할 때도 업데이트 날짜와 공식 도움말을 우선합니다.

  • 공식 문서가 있는 정보는 원문 기준으로 확인합니다.
  • 통계나 수치를 사용할 때는 출처, 조사 범위, 기준일을 함께 적습니다.
  • 개인 경험에서 나온 판단은 “경험상”, “해당 사례에서는”처럼 범위를 제한합니다.
  • 출처가 불확실한 문장, 반복되는 일반론, 근거 없는 순위 표현은 삭제합니다.

내용과 표시 확인

수정할 글에서는 제목과 본문의 범위, 예제의 조건, 출처와 광고성 여부를 확인 대상으로 삼습니다. 화면에 관한 설명은 문서 구조만으로 판단할 수 있는 부분과 실제 브라우저 동작이 필요한 부분을 구분합니다.

  • 제목은 본문에서 설명하거나 확인한 범위를 넘어가지 않습니다.
  • 코드, 표, 수치와 그림은 독자가 어떤 문제에 적용할 수 있는지 설명합니다.
  • 화면 확인 결과를 제시할 때는 대상과 환경을 적고 확인하지 않은 기기까지 일반화하지 않습니다.
  • 오탈자 수정과 사실·기능 변경은 구분합니다.

발행과 수정

글의 발행일과 수정일은 문서의 이력을 나타냅니다. 날짜만으로 정보의 정확성이나 모든 화면의 점검 완료를 의미하지는 않습니다. 예약된 글은 실제 공개되기 전까지 독자가 볼 수 있는 자료에 포함하지 않습니다.

업데이트가 필요한 기능이나 정책을 다룬 글은 연결된 공식 문서의 적용 범위를 함께 확인해야 합니다. 설명이나 예제가 바뀌면 본문에서 독자가 영향을 받는 부분을 고칩니다.

반복과 독자 가치

글의 길이, 소제목 수, 출처 수만으로 품질을 판단하지 않습니다. 같은 안내문이나 결론을 여러 글에 붙이기보다 해당 주제의 입력값, 비교 과정과 적용 조건을 설명하는 것이 작성 기준입니다.

  • 설명용 예제와 실제 관측 결과를 구분합니다.
  • 다른 글에서 반복한 절차는 필요한 부분만 연결하고 주제와 무관한 분량을 늘리지 않습니다.
  • 출처의 이름과 HTTP 응답만으로 원문의 내용이 주장을 뒷받침한다고 판단하지 않습니다.
  • 실제 사용·측정·고객 성과를 확인하지 않았다면 그런 결과를 작성하지 않습니다.

수정과 정정

오류가 확인되면 가능한 한 빠르게 수정하고, 독자가 판단하는 데 영향을 줄 수 있는 오류는 수정 사실을 남깁니다. 단순 오탈자나 문장 다듬기는 별도 공지 없이 수정할 수 있습니다.

사실 오류
정책, 날짜, 기능, 수치 등 사실 관계가 틀린 경우 본문을 수정하고 필요하면 수정일을 표시합니다.
해석 오류
사례를 지나치게 일반화했거나 맥락 설명이 부족한 경우 조건과 한계를 보완합니다.
독자 요청
정정 요청은 rushbee26@gmail.com으로 받을 수 있으며, 확인 가능한 근거가 있으면 우선 검토합니다.