LE3 - User Documentation

1 / 26
volgende
Slide 1: Tekstslide
ICTMBOStudiejaar 1

In deze les zitten 26 slides, met interactieve quizzen, tekstslides en 2 videos.

Onderdelen in deze les

Slide 1 - Tekstslide

Slide 2 - Tekstslide

LE3 - User documentation
This term English combined with IT.
  1. A written user instruction in English (individual)
  2. An English video instruction (Teams) (in pairs)
  3. Helpdesk telephone call (Teams) (in pairs)

    (so if you are exempt it might be wise to follow class)

Slide 3 - Tekstslide

LE3 - User documentation
Goals?
  • I will learn how to write a clear instruction manual
  • I will know what a clear instruction manual is
  • I will learn to make a clear video instruction

Slide 4 - Tekstslide

Have you ever read a manual?
Yes
No
WTF?

Slide 5 - Poll

timer
1:00
What is user documentation?

Slide 6 - Woordweb

Slide 7 - Tekstslide

What does a good user documentation need?
timer
1:00

Slide 8 - Open vraag

Slide 9 - Tekstslide

Common mistakes
Grammar issues
Native language influence
Bad structure
Lack of details
Lack of pictures


Slide 10 - Tekstslide

Benefits of User Documentation
  • Customer satisfaction
  • Support team productivity
  • Customer experience

Slide 11 - Tekstslide

Slide 12 - Video

Slide 13 - Tekstslide

Look at the instruction, is it clear, why / why not?

Slide 14 - Open vraag

timer
1:00
Identify the Audience
Define the Purpose of the Manual
Graphics
Be brief and clear
Identify the How-To Steps
Test it.
1
2
3
4
5
6

Slide 15 - Sleepvraag

First steps
Step 1: Identify the Audience
Step 2: Define the Purpose of the Manual
Step 3: Identify the How-To Steps
Make them clear and step by step
Step 4. Graphics
Step 5: Be brief and clear
Step 6: Test it.

Slide 16 - Tekstslide

  •     Choose an appropriate font. (Arial or Calibri.)
  •     Don’t use a font smaller than 10-point type.
  • Depending on your audience, you may need to use a larger font.
  •     Use headings to highlight transitions from one section to another.
  • Include subheadings within heading sections as needed.
  •     Present steps that must be followed in order in a numbered list format.
  •     Use bulleted lists and/or tables to highlight key information.

Slide 17 - Tekstslide

Without pictures make an instruction how I have to make a cuppa tea. (in steps)

Slide 18 - Open vraag

Part 2
Video Instruction:

Slide 19 - Tekstslide

Slide 20 - Tekstslide

Slide 21 - Video

What?
An instructional video is any video that demonstrates a process, transfers knowledge, explains a concept, or shows someone how to do something.

(So, basically your written instruction translated to video :) )

Slide 22 - Tekstslide

Micro videos

Micro videos are short instructional videos that focus on teaching a single, narrow topic. They’re usually less than a minute long and appeal to today’s media consumers, who have notoriously short attention spans.

Tutorial videos

Tutorial videos are the go-to instructional method for teaching a process or providing step-by-step instructions. Usually between 2-10 minutes long, tutorial videos may leverage multiple instructional methods.

Sometimes referred to as “how-to” videos, the best ones are carefully planned and have a professional touch.

Slide 23 - Tekstslide

How
  • Use a script
  • Be clear and precise (vocal and visually)
  • Don't use fancy FX
    (Or funky music)
  • Know who you are talking to
  • Make it flow.
  • Test it
  • Make the customer happy!

Slide 24 - Tekstslide

Tools?
  • Windows Steps Recorder
  • Teams
  • Discord
  • Free tools

Slide 25 - Tekstslide

Have we met our goals?
😒🙁😐🙂😃

Slide 26 - Poll