시각적 개체를 사용하여 단계별 지침을 만드는 방법

독자가 이해하기 위해 텍스트보다 더 많은 것을 요구하는 튜토리얼이 있습니다. 시각 자료를 사용하여 단계별 지침을 작성함으로써 독자에게 전달되지 않았을 수 있는 세부 사항에 대한 핵심 정보를 제공할 수 있습니다. 이러한 시각 자료는 정지 이미지 또는 스크린샷, 애니메이션 GIF, 비교 차트 또는 비디오일 수 있습니다. 독자가 콘텐츠를 이해하도록 돕는 것 외에도 시각적 개체는 많은 양의 텍스트의 단조로움을 없애줍니다.

작년에 저는 Joyent의 기술 작가로 일하면서 모든 기술 수준의 사용자를 대상으로 지침을 작성하고 비디오를 제작했습니다. 이를 위해서는 정확성이 필요합니다. 사람들은 기술 작업에 대한 단계별 지침과 가이드를 작성하기 위해 저에게 의존합니다. 내가 한 단계를 놓쳤거나 독자가 이미 정보를 알고 있다고 가정하면 실망한 나머지 다시 우리 콘텐츠로 돌아오지 않을 수 있습니다. 반면에 너무 상세하면 콘텐츠가 과도하고 복잡하게 느껴질 수 있으며 더 자주 업데이트해야 합니다. 부담없이.

이미지가 지나치게 정확한 세부 사항 중 일부를 대체할 수 있는 위치를 찾는 것은 시간과 에너지를 절약합니다. 또한 독자는 자신의 삶을 더 쉽게 만들어 줄 것으로 기대하는 것이 무엇인지 알면서 자리를 떠납니다. 가능하면 몇 가지 주요 작성 조언을 따르십시오. 보여주고 말하지 마십시오(매우 중요하므로 자체 Wikipedia 페이지가 있습니다).

정확한 프로세스 용어의 이점을 얻기 위해 기술 작성자가 될 필요는 없습니다. 지침을 준비하고 문서에 시각적 개체를 추가하기 위한 전략을 계속 읽으십시오.

시각화를 시작하기 전에 청중을 고려하십시오

콘텐츠를 제작하기 전에 누구를 위해 콘텐츠를 제작하고 있으며 그들의 기대치가 무엇인지 알아야 합니다. 각 독자의 개별 요구 사항을 예측하는 것은 불가능하지만 설정하는 규칙은 콘텐츠의 분위기에 영향을 미치고 나중에 프로세스 개요를 작성할 때 결정을 내리는 데 도움이 될 수 있습니다.

다음을 고려하세요:

• 내 독자는 이미 전문가입니까? 비슷한 상황에서 정확히는 아니지만 이전에 이 프로세스를 수행한 적이 있습니까?
• 내 독자는 내부입니까 아니면 외부입니까? 내 독자가 같은 회사에 있는 경우 프로세스를 더 잘 설명하는 데 도움이 되는 어떤 언어를 공유합니까?
• 그들은 어떤 기분으로 내 콘텐츠에 올까요? 나는 무언가를 끝내기 위해 서두르는 사람을 위해 이 콘텐츠를 만들고 있습니까, 아니면 주제에 대한 교육을 계속하기를 바라는 좀 더 캐주얼한 학습자를 위한 것입니까?
• 독자들에게 가장 중요한 것은 무엇입니까? 가장 덜 중요한 것은 무엇입니까?
• 독자들은 어떻게 배우는 것을 선호합니까? 블로그 게시물이 비디오보다 더 성공적인지 알고 있습니까? 이러한 주장을 뒷받침하는 분석 데이터가 있습니까?
• 내 독자들은 영어가 모국어입니까? 관용구를 사용하면 프로세스를 완료하는 방법을 배우는 데 방해가 됩니까?

당신이 무엇을 만들고 있든, 당신은 항상 반대편에 있는 독자와 함께 그것을 만들고 있습니다. 독자를 더 잘 알고 독자를 염두에 두고 콘텐츠를 제작할수록 독자는 더 많은 콘텐츠를 위해 계속 돌아올 가능성이 높아집니다.

필요한 만큼만 세부적으로 프로세스 개요

모든 매체에 대한 프로세스 또는 자습서를 준비하는 한 가지 방법은 2열 테이블로 시작하는 것입니다. 첫 번째 열에는 독자가 작업을 완료하기 위해 수행해야 하는 각 개별 단계가 포함됩니다. 이러한 단계는 "지원서 제출"만큼 작고 정확하거나 "양식의 나머지 부분 작성"과 같이 크고 구체적이지 않을 수 있습니다.

두 번째 열은 시각적 프로세스 열입니다. 처음에는 실제 시각적 개체가 전혀 포함되지 않을 수 있지만 시각적 개체에 대한 설명입니다. 서면 문서를 만드는 경우 1열의 모든 단계에 대해 일치하는 시각적 개체가 필요하지 않습니다. 스크린캐스트를 만들 경우 모든 상자에 포함할 시각적 개체 유형에 대한 메모가 있어야 합니다. 비디오에는 빈 화면 시간이 거의 또는 전혀 없어야 합니다.

이 표의 예는 아래 "예제 개요"에 있지만 먼저 시각 자료의 유형에 대해 더 많이 알아야 합니다.

시각 자료의 종류와 사용 시기

모든 프로세스는 다양한 유형의 시각적 개체로부터 이점을 얻을 수 있습니다. 매체는 목적에 따라 달라집니다.

• 스틸 이미지 – 이것은 사람이든 팬과 같은 특정 물체이든 실제 제품을 시각화하려고 할 때 완벽한 매체입니다. 스톡 사진이나 촬영한 사진이 될 수 있습니다.
• 스크린샷 – 웹 사이트나 다른 소프트웨어와 같이 컴퓨터에 표시되는 제품에 대해 이야기할 때 화면의 정지 이미지가 좋습니다. 특히 Snagit 덕분에 매우 쉽게 가져오고 편집할 수 있습니다.
• GIF – 애니메이션 이미지는 쉽게 표현되지 않을 수 있는 짧은 프로세스(8초 미만)를 설명하는 데 적합합니다.
• 차트 – 막대 차트, 파이 차트, 꺾은선형 차트, 다양한 유형의 차트! 차트는 숫자 집합에 대해 이야기하고 비교할 때 가장 좋은 선택입니다.
• 비디오 – 궁극적인 시각 효과를 제공하는 비디오는 프로세스를 설명하는 데 적합합니다. 훌륭한 기술 비디오를 만드는 방법은 이 과정에서 확실히 도움이 될 수 있지만 훨씬 더 많은 계획이 필요한 예술 형식입니다. (다행히 TechSmith에서 많은 것을 배웠고 그들은 이 주제에 대해 할 말이 더 많습니다).

글쓰기에 다양한 매체를 자유롭게 사용하세요. 각각은 다른 단계에 대한 다른 요구 사항을 충족합니다.

예시 개요

레시피는 시각적으로 큰 차이를 만들 수 있는 정밀도가 종종 요구되는 프로세스의 가장 좋은 예 중 하나입니다. 케이크 만들기 지침을 설명하고 싶다고 가정해 보겠습니다.

테이블 {

경계 접기: 접기;

}

테이블, TD, 일 {

테두리: 1px 솔리드 #404040;

패딩:4px;

}

모든 단계에 이미지가 있다면 그것은 약간... 무료입니다.

영상을 선택하세요

내가 선택한 이미지는 더 큰 프로세스 내에서 미니 프로세스를 명확하게 설명하는 데 도움이 됩니다. 특히 지금까지 섞인 7단계의 사진은 결정적인 시각적 증거물이다. 이 지시로 많은 케이크를 구웠는데, 딱 맞는 것과 너무 섞인 것의 차이... 항상 사진이 있었으면 좋겠어요. 얼마나 오래 혼합해야 하는지에 대한 복잡한 설명만 적힌 사용 설명서가 있을 수 있습니다. 다른 모든 페이지는 이미지여야 합니다.

어떤 비주얼이 필요한지 간략하게 설명한 후 상품을 수집해야 합니다. 이 예에서는 케이크를 굽는 과정을 사진으로 찍는 것이 가장 좋습니다. 다른 프로세스의 경우 사용자 지정 사진을 찍을 필요가 없을 수 있습니다. 귀하의 재량에 따라 사용할 수 있는 비디오, GIF 및 정지 사진이 있는 다양한 무료 및 프리미엄 스톡 사진 웹사이트가 있습니다.

대상 고객과 함께 테스트

타겟 청중의 누군가가 읽고 승인을 받을 때까지는 글이 완성되지 않습니다. 그들의 입력은 프로세스에서 어느 단계를 놓쳤는지 또는 더 많은 시각 자료가 필요한 부분을 보여줍니다.

사용성 팀의 많은 리소스 없이 이 문제를 해결하는 가장 쉬운 방법은 주요 인구 통계에서 몇 사람에게 콘텐츠를 읽고 작성된 대로 정확하게 프로세스를 따르도록 요청하는 것입니다. Jakob Nielsen은 5명이 가장 많은 문제를 파악하는 데 가장 좋은 수라고 말한 것으로 자주 인용됩니다.

중재되지 않은 테스트

중재되지 않은 테스트는 리소스가 제한된 소규모 프로젝트에 적합하거나 결과가 빨리 필요할 때 적합합니다. 더 정확한 결과를 위해 사용할 수 있는 도구가 많이 있지만 더 작은 프로세스에 대한 피드백을 찾고 있다면 원하는 질문 세트가 포함된 문서를 테스터에게 보내는 것만으로도 충분할 수 있습니다. 대답했다.

테스터에게 질문이 있을 때마다 메모를 하도록 요청하거나, 누락되었을 수 있는 항목을 확인하거나, 프로세스에서 장애물에 부딪히거나, 더 자세한 지침이 제공되기를 바랍니다. 피드백을 제공하기 전에 그들이 작업을 완료할 수 있기를 바랍니다.

중재 테스트

중재된 테스트의 가장 큰 이점은 테스터가 프로세스를 수행하는 것을 실제로 관찰할 수 있고 혼란스러운 점을 확인하기 위해 테스터에게 의존하는 대신 그들이 혼란스러운 부분을 볼 수 있다는 것입니다. 세션을 녹음하여 이 세션 동안 작성한 메모에만 전적으로 의존할 필요가 없도록 하면 더욱 좋습니다.

길을 따라 질문하십시오. 예를 들어:

• 수행하도록 요청받은 작업을 이해했습니까? 그 작업이 의미가 있었나요?
• 이 프로세스를 더 쉽게 완료할 수 있었던 이유는 무엇입니까?
• 단계가 있는 시각적 개체가 있는 경우 시각적 개체가 수행할 작업을 이해하는 데 도움이 되었습니까?
• 더 많은 비주얼이 있었으면 하는 바람?

마무리

이제 단계별 지침에 시각적 개체를 추가해야 하는 이유와 시각적 보조 도구를 사용하여 단계별 지침을 성공적으로 생성하는 데 도움이 되는 다양한 도구를 보유해야 하는 이유를 알게 되었습니다. 연습이 완벽을 만듭니다. 프로세스에 이미지를 추가하려는 첫 번째 시도는 완벽하지 않을 수 있지만 편집 프로세스를 안내하는 일부 사용자 테스트를 통해 사용자가 작업을 완료하는 방법을 이해하는 데 도움이 될 것입니다.

지침에 시각 자료를 추가해야 하는 시점을 파악하는 다른 방법이 있습니까? 아래 댓글에 팁을 공유하세요!

편집자 주: 이 게시물은 원래 2017년 11월에 게시되었으며 정확성과 포괄성을 위해 업데이트되었습니다.