자습서 작성

오타 3 자습서의 첫 번째 섹션에서 지금까지 사용 된 텍스트:

“이 문서는 자습서입니다. 튜토리얼은 단계별 지침이 될 수 있도록 설계특히 처음부터 끝까지 특정 작업을 통해 초보자를 걸어 만들었습니다. 효과적인 학습을 용이하게하기 위해 자습서는 그들이 다루는 주제를 설명하는 예제를 제공합니다. 또한 자습서에서는 일반적인 함정을 피하는 방법에 대한 지침을 제공하고 나중에 참조 할 수 있도록 기억해야 할 주요 개념을 강조 표시합니다.”

아래에 언급 된 문헌을보고에서 우리는 다음과 같은 핵심 사항을 고려해야한다:

• 튜토리얼은 학습 지향적이며,무언가를 완성하는 단계를 보여 주며,독자가 더 많은 지식을 갖도록 만드는 교훈입니다.
• 독자는 의미있는 것을 달성하고 성공을 경험하고,그것을 행할 수 있고 즐겁게 찾고,능력을 향상시키고,자신감을 얻고,다시하고 싶어합니다.
• 이론적 지식이 아닌 실용적인 지식에 집중하십시오. 새로운 기술이나 기술을 배우고

지침을 수행하여 학습에 집중하십시오.:

• 사용자가 수행하여 학습 할 수 있도록 허용,
• 단순에서 복잡한
• 사용자가 시작하기
• 그것은 초보자가 가장 잘 이해하는 단계를 보여 괜찮습니다. “모범 사례”는 다른 것일 수 있습니다. 숙련 된 사용자가 어떻게 할 것인가는 다른 것일 수 있습니다.
• 목표는 독자를 최종 목적지로 데려가는 것이 아니라 독자를 시작하는 것입니다.
• 튜토리얼이 작동하는지 확인하십시오!
• 초보자의 자신감을 고취: 소프트웨어에서,튜토리얼에서,튜터에서,그리고 물론,그들에게 요구되는 것을 성취 할 수있는 자신의 능력에서.
• 사용자가 즉시 결과를 볼 수 있도록
• 튜토리얼의 각 섹션 또는 전체 튜토리얼의 결론은 의미있는 성취해야합니다.
• 자습서는 안정적으로 반복 가능해야 합니다.
• 추상적 개념이 아닌 구체적인 단계에 초점을 맞춘다. 추상화를 소개하는 유혹은 거대하다:저항!
• 필요한 최소한의 설명 제공
• 사용자가 수행해야 하는 단계에만 집중