기억하기 회상하기

매개변수부터 오류 코드까지 외울 수 없었던 정보를 되새깁니다.

일곱 가지 행동 문서화 모델현재 위치: remember

여러 해가 지나도 문서가 계속 가치를 지니는 이유 가운데 하나는 참조 자료로서의 유용성입니다. 매개변수, 오류 코드, 허용값처럼 외울 수 없었던 정보 조각을 기억하고, 회상하고, 되찾고, 찾아보기 위해 매뉴얼을 훑습니다.

기억을 돕는 문서의 예로는 Dockerfile 참조 문서GitLab CI/CD YAML 구문 참조 문서가 있습니다. 사용자가 여러 기술적 “주문”을 실행하기 위해 되새겨야 하는 세부 정보를 검색하기 쉽고 고도로 구조화된 형태로 제공합니다.

참조 문서는 제품을 장기적으로 사용할 수 있게 하는 기반입니다. 다른 행동을 충족하기 위한 문서는 한 번 읽고 내재화할 수 있지만, 참조 자료는 사용자가 전문성을 쌓고 점점 더 정교한 구현을 다루는 동안 계속해서 가치를 발휘합니다.

사용자가 하려는 일

참조 자료는 여러 해가 지나도 문서의 가치를 유지합니다. 사용자는 외우지 못한 정보 조각을 기억하고, 회상하고, 되찾고, 찾아보기 위해 매뉴얼을 훑습니다.

문서가 이 요구를 놓치고 있다는 신호

  • 사용자가 매개변수나 오류 코드를 검색해도 아무것도 찾지 못합니다.
  • 참조 정보가 블로그 글과 채팅 기록에 흩어져 있습니다.
  • 제품의 구문이나 설정을 다루는 검색 가능하고 구조화된 참조 문서가 없습니다.

실제 사례 두 가지

일반적인 콘텐츠 유형

DITADiátaxisGood Docs Project
<reference>, <refsyn>, <properties>참조 문서참조 문서, 용어집

하나의 지표

참조 검색 적중률 · 올바른 페이지를 반환한 참조 검색의 비율입니다.