본문으로 건너뛰기
인터페이스 언어: 한국어
디자인 / Signal

웹사이트의 제품 설명서: 추측 없이 처음 사용하기

올바른 버전, 행동 순서, 이미지와 결과 확인을 포함한 첫 사용 설명서를 준비합니다.

본문 언어: 한국어

여성이 고양이와 불빛 가까이에서 흰 꽃잎 모양의 물체를 살펴봅니다.
목차

상자를 열었습니다. 한눈에 중요해 보이는 부품 하나를 빼면 모두 익숙해 보입니다. 제품 페이지에는 아이디어에 대한 아름다운 설명, 실내 사진 세 장, ‘설명서_final_수정_2’ 다운로드 버튼이 있습니다. 하지만 지금 고객에게는 훨씬 작은 질문의 답이 필요합니다. 모든 것을 바닥에 다시 펼치지 않으려면 어디서 시작해야 할까요?

첫 사용 설명서는 받은 제품에서 알아볼 수 있는 첫 결과까지 사람을 이끌어야 합니다. 제품의 탄생 역사 전체를 담거나 제조사의 완전한 문서를 대신할 필요는 없습니다. 올바른 버전, 준비, 행동 순서, 중요한 단계의 성공 여부를 확인하는 방법은 제시해야 합니다.

가상의 책상 정리함을 생각해 봅시다. 받침대, 칸막이 두 개, 작은 물건용 삽입재로 구성됩니다. 전기 설치나 특별한 자격이 필요한 행동이 없는 단순한 제품입니다. 편집을 설명하기에 편리한 예시입니다. 실제 제품의 기술 내용, 경고, 허용된 사용 방법은 제품 책임자가 승인해야 합니다. 웹 디자이너는 이 지식을 읽기 쉬운 경로로 배열합니다.

회사 드라이브 구조가 아니라 상자에서 시작한다

쓰기 전에 제품과의 첫 만남을 재구성하세요. 사람 앞에 무엇이 있나요? 모델은 어떻게 알아보나요? 어떤 부품이 비슷해 보이나요? 포장 이름이 제품 페이지와 일치하나요? 설명서를 찾기 위해 내부 카탈로그 코드를 알아야 한다면 먼저 식별 경로를 개선하세요.

이 정리함의 첫 화면에는 밝은 배경에 펼친 구성품 사진과 세 가지 부품의 이름을 보여 줄 수 있습니다. 수량은 이름 옆에 보여야 합니다. 우아한 그림만으로는 두 번째 칸막이가 사라진 것인지 원래 이 버전에 없었던 것인지 판단할 수 없습니다.

어떤 버전을 위한 설명서인지 밝히세요. 받침대 크기나 고정 방식이 거의 같은 두 버전을 구분할 수 있습니다. 고객이 절차를 시작한 뒤 여섯 번째 단계에서야 차이를 발견하게 하지 마세요. 하나의 자료가 여러 버전을 다룬다면 시작할 때 경로 선택을 설명하고 이후 차이를 일관되게 표시합니다.

부품 이름은 상자와 그림의 표시와 맞아야 합니다. 팀 대화에서 ‘막대’, ‘칸막이’, ‘지지대’가 같은 부품을 뜻할 수 있지만 처음 보는 사람은 모릅니다. 한 가지 명칭과 필요할 경우 코드를 고르세요. 코드는 부품을 가리키는 데, 이름은 역할을 설명하는 데 도움이 됩니다.

시작 전에 필요한 것을 적으세요. 이 예에서는 비어 있는 탁자 공간과 구성품 확인입니다. 다른 제품에서는 준비 범위가 다를 수 있습니다. 비슷한 작업의 도구 목록을 복사하지 마세요. 나열한 각 물건은 승인된 절차에서 나와야 합니다.

언제 멈춰야 하는지도 알려 줄 가치가 있습니다. 부품이 그림의 버전에 맞지 않거나 무언가 빠졌다면 고객은 어떻게 설명을 얻을지 알아야 합니다. 설명서가 모든 장애물을 더 큰 힘과 그림에 대한 더 큰 신뢰로 극복해야 한다고 가정해서는 안 됩니다.

자료를 찾는 것도 설계의 일부입니다. 포장이나 종이 안내문에서 연결한다면 올바른 설명서 버전을 포함해 QR 코드의 목적지 (폴란드어)를 확인하세요. 링크는 제품 페이지, 도움말, 구매 후 거래 메시지 (폴란드어)에 나타날 수 있습니다. 모든 경로가 올바른 버전으로 이어져야 합니다. 고객은 어느 메시지에 설명서가 있었는지 기억하지 못한 채 훨씬 나중에 다시 찾곤 합니다.

공개 설명서를 읽기 위해 주문 정보를 다시 입력하도록 요구하지 마세요. 다른 접근 방식이 필요한 자료라면 명확히 설명합니다. 고객은 제품 자체를 진단하기 전에 지식에 도달하는 절차를 알아야 합니다.

첫 세 가지 행동을 적는다

가상의 정리함을 위한 작업용 버전은 다음과 같습니다.

  1. 사진에 따라 구성품을 확인합니다. 받침대, 동일한 칸막이 두 개, 삽입재 하나가 있어야 합니다.
  2. 그림에 표시된 대로 받침대를 탁자에 놓습니다. 앞면 표시는 그림에 나온 쪽에 있어야 합니다.
  3. 첫 칸막이를 표시된 위치에 놓습니다. 두 번째를 넣기 전에 완성된 단계의 모습과 위치를 비교합니다.

이는 작성 방식의 예시이지 실제 제품의 설명서가 아닙니다. 각 단계에 행동과 확인 조건이 있습니다. 실제 자료에는 구조에서 나오는 승인된 정보가 더 필요합니다. 둘을 나누면 고객이 무엇을 할지는 알아도 올바르게 했는지는 모르는 공백을 쉽게 발견할 수 있습니다.

WordPress 절차 작성 지침은 실제 수행 순서를 따르고 정해진 행동이나 결과로 끝내라고 권합니다. 그 플랫폼 문서에 대한 규칙입니다. 물리적 제품에는 명확한 순서의 원칙만 활용하며 구체적 행동의 내용은 제조사의 지식에 속합니다.

독립적인 여러 행동을 긴 한 단계에 섞지 마세요. 고객이 휴대전화를 내려놓고 행동한 뒤 돌아왔을 때 위치를 쉽게 찾아야 합니다. 반대로 모든 작은 움직임을 별도 화면으로 나누면 전체를 이해하기 어려울 수 있습니다. 알아보고 확인할 수 있는 단계가 경계를 정합니다.

중단 후 돌아오는 방법도 계획하세요. 단계 이름과 현재 상태 그림은 첫 칸막이를 이미 추가했는지 알아보게 합니다. 긴 절차에서는 단계 목록이 유용할 수 있지만 시스템이 관찰하지 못하는 행동이 완료된 것처럼 보여서는 안 됩니다. 다음 문단을 열었다고 제품에 대한 작업을 수행한 증거가 되지는 않습니다. 진행 표시는 고객을 도와야지 거짓 확인을 만들어서는 안 됩니다.

사람이 필요한 곳에 예상 결과를 제시하세요. 해당 이미지 옆의 ‘칸막이는 보이는 위치에 있어야 합니다’는 즉시 도움이 됩니다. 페이지 끝의 일반적인 ‘올바르게 조립하면 제품이 준비됩니다’는 몇 분 전에 생긴 실수를 찾는 데 도움이 되지 않습니다.

Aeneia 콘셉트 사진

이미지는 글이 설명하는 바로 그 행동을 보여야 한다

첫 사진은 완성된 정리함의 사용 모습을 보여 줄 수 있습니다. 하지만 단계에는 올바른 부품, 연결 위치, 방향을 보여 주는 다른 장면이 필요합니다. 설명용 사진을 캠페인에서 탈락한 사진으로 취급하지 마세요. 자체 역할이 있습니다.

사진 사이에 분명한 기준점을 유지하세요. 제품이 갑자기 반 바퀴 돌아간다면 그 변화를 표시하거나 더 넓은 화면을 보여 줍니다. 작성자는 물건을 알아 방향을 쉽게 재구성합니다. 고객은 그 순간 받침대를 거꾸로 들고 비슷한 구멍 두 개를 비교하고 있을 수 있습니다.

iFixit의 안내서 단계 도움말은 단계 제목이 내용을 설명하고 이미지 표시를 해당 텍스트 항목과 연결할 수 있다고 안내합니다. 설명서 요소를 일관되게 연결하는 예입니다. 자사 자료에 이 관계를 적용하기 위해 특정 색상을 복사할 필요는 없습니다.

표시를 사용한다면 의미를 유지하세요. 움직임을 가리키는 화살표가 다음 이미지에서 임의의 세부 사항을 뜻해서는 안 됩니다. 부품 번호와 단계 번호가 경쟁해서도 안 됩니다. 검수 시 프로젝트 밖의 사람에게 행동하기 전에 각 표시가 무엇을 가리키는지 짚어 달라고 요청하세요.

색상은 구분을 도울 수 있지만 텍스트에도 이름이나 번호를 적으세요. ‘초록색으로 표시한 부품을 넣으세요’는 색상을 인식해야 합니다. ‘칸막이 A를 위치 A에 넣으세요’는 다른 식별 경로를 줍니다. 제조사가 인쇄 사용을 예상한다면 인쇄물에서도 표시를 확인해야 합니다.

휴대전화에서는 세부 부분을 읽을 수 있는 크기로 보여 주세요. 페이지가 고해상도 파일을 좁은 띠로 표시한다면 파일 해상도만으로 충분하지 않습니다. 확대 후 같은 단계로 돌아올 수 있어야 합니다. 세부 사항을 본 뒤 설명서의 처음으로 돌아가서는 안 됩니다.

움직임에 의미가 있을 때 짧은 영상이 도움이 됩니다. 멈추고 중요한 순간을 찾을 수 있게 하세요. 일반적인 글 설명도 전체를 다시 보지 않고 단계로 돌아가는 데 도움이 됩니다. 특히 좁은 화면에서 사용할 자료라면 서비스 페이지에 동영상 삽입 (폴란드어)과 함께 결정할 가치가 있습니다.

상황에 따라 게시 형식을 고르세요. HTML은 콘텐츠 직접 링크와 화면 조정을 쉽게 합니다. PDF는 다운로드나 인쇄 필요에 맞을 수 있지만 별도 준비가 필요합니다. PDF와 HTML의 선택 (폴란드어)에서 아무 파일이나 올리면 설명서 설계가 끝난다고 가정하지 마세요.

두 형식을 모두 제공한다면 공통 출처 또는 업데이트 절차를 정하세요. 별도로 유지하는 두 자료는 부품이 바뀐 뒤 쉽게 달라집니다. 고객이 페이지 날짜, 파일 이름, 메시지 속 이미지 중 무엇이 더 최신인지 결정해서는 안 됩니다.

웹사이트 프로젝트에서 Aeneia Design은 승인된 자료에 명확한 구조와 고객 경로상의 위치를 주는 데 도움을 줄 수 있습니다.

실제 과제로 설명서를 확인한다

시험에는 맞지 않는 버전의 설명서도 준비하고 참가자가 시작 전에 차이를 알아보는지 확인하세요. 잘못된 행동을 실제로 할 필요는 없습니다. 제품 표시에 따라 올바른 자료를 고르라고 요청하면 됩니다. 이런 시험은 버전 이름과 첫 이미지가 실제로 혼동을 막는지, 아니면 카탈로그에서 나란히 보기 좋기만 한지 드러냅니다.

시험에는 제품 또는 행동을 신뢰할 수 있게 재현한 것, 최신 설명서, 미래 고객과 비슷한 경험을 가진 사람이 필요합니다. 작성자는 관찰해야 합니다. 내내 어디를 봐야 하는지 설명한다면 설명서의 독립성보다 자신의 인내심을 시험하는 셈입니다.

멈추는 지점을 기록하세요. 알아보지 못한 부품, 불명확한 사진, 빠진 확인, 단계로 돌아오기 어려운 상황입니다. 모든 멈춤을 오류라고 부르지 마세요. 사람이 이미지와 물건을 조심스럽게 비교할 수도 있습니다. 자료가 필요한 답을 주지 않아 추측해야 할 때 문제가 시작됩니다.

단계를 수행한 뒤 무엇으로 성공을 알아보았는지 참가자에게 물어보세요. ‘대충 맞아 보였다’고 답한다면 설명서가 충분히 구체적인 결과를 보여 주는지 확인합니다. 곧바로 경고를 더하지 마세요. 완성된 연결부의 더 나은 그림이나 간단한 부품 이름이면 충분할 수 있습니다.

지식 부족과 언어 문제를 구분하세요. 행동에 전문 교육이 필요하다면 더 예쁜 글이 이를 대체하지 못합니다. 반면 고객이 회사 내부에서만 쓰는 말을 이해하지 못한다면 명칭을 고칩니다. 인터페이스 메시지의 브랜드 목소리 (폴란드어)에서도 과제를 돕는 일이 장식적인 표현보다 우선합니다.

시험 질문은 FAQ (폴란드어)에 넣을 수 있지만 기본 행동을 페이지 끝 답변에 숨기지 마세요. 여러 사람이 받침대를 어느 방향으로 놓는지 묻는다면 해당 단계를 고칩니다. 자주 묻는 질문 목록을 늘리는 것이 설명서 수정을 대신해서는 안 됩니다.

마지막으로 자료 책임자와 검토 계기를 정합니다. 새 제품 버전, 구성품 변경, 다른 부품 표시는 설명서 확인을 시작하게 해야 합니다. 현재 자료와 오래된 자료를 구분할 수 있는 곳에 모델, 버전, 승인 날짜를 기록하세요. 파일 이름의 ‘최종’은 희망의 표현이지 버전 관리 체계가 아닙니다.

좋은 설명서는 전체 이력을 다시 떠올리지 않고 시작하고 멈추고 돌아올 수 있게 합니다. 첫 사용 후 다른 질문으로 다시 필요할 수 있습니다. 그때 명확한 단계 이름과 안정적인 게시 위치는 정성껏 준비한 첫 사진만큼 유용합니다.

Aeneia / Aeneia 편집부

편집부의 글입니다. 본문에 출처 링크가 있습니다.

Aeneia 소개

함께한 브랜드

  • L’Oréal
  • Garnier
  • Netflix
  • Carrefour
  • Warner Bros. Discovery
  • Biedronka
  • HBO Max
  • Wolt
  • Żabka
  • COSRX
  • 주폴란드 중국대사관
  • Mixa
Aeneia / Initium

지식에서 결정으로

정리하고 싶은 과제를 알려 주세요. 어디서 시작할지 함께 정합니다.

Aeneia에 문의하기

파트너의 솔루션을 활용합니다

  • Google
  • OpenAI
  • Microsoft
  • Stripe
  • Anthropic
  • Linear