説明の順番も大事な情報 / Explanation order is also important information

説明したいことを思いつくままに書いてみたら、思いのほか多くなってしまい、書き終わってみたら分かりにくいって感じたり、言われたりしたことはありませんか。実は、説明の順番も読者にとっては大切な情報です。どんな順番で説明していくとうまく伝わるのか、テクニカルライターが気にしているポイントを紹介します。

■ 発表者
矢崎 誠 / LINE株式会社 テクニカルライター
https://twitter.com/yazakimakoto

■ セッション動画
https://www.youtube.com/watch?v=A8MDWZyusgw&t=941s

※こちらは以下イベント内で発表した内容です
https://line.connpass.com/event/207045/

Transcript

1.  
    Yazaki Makoto 2021.04
2.    
      00 01 02 03 Contents
3. ng • I i 0 8 1 6 81 8 P l • ND CI A • 9 0 8 1 E L e 080462 e B a
4. . . 3 0 1 01 02 03
5.  $ #     & '%   !(   "
      )   https://www.youtube.com/watch?v=nmFVXJGiCxM&t=1019s
6.   
       L L 1 W Meetup IN E IN E IN E W IN E IN E
7.  #2)'(  LINE$ +0    6G7 %LINE'*(1/<W %MO  LINE8J'*(1/ LINE "#!P:5T YV-).+  1,&/ 1) $ $LINE "#!&U Q> 2) [
   ] $LINE "#! /+IF&,.0 3) [+0  ] &,.0 4) P:5T  # :?;#CK&A =?&N4%"D@ 2) HZX!ER % &X3 *.BL%"D@ %- HZ29S  
8. LINE" -(; F  &!'# NkO -LINE/41@:Z -xz #LINEQr/41@: LINE*,)"~V!L‡ ‘Š!8295$ I=0E 1) ++LINE*,).ˆ !‚\ 2) [(
   #]+LINE*,)" :5qi.79< 3) [; F  &!'#] .79< 4) ~V!L‡ %(,K923  %(, V]X)bu._ [].yK-'"c^ K9 "l’#&fƒ - .E :?`v-'"c^ .> "l’BR!„  • l’";>36=@.Œ|g,$* • aJ.AD!$* • S€…€.M+!- • l.-".“}- • l.-”tjP.kc^.Gv- • €Ž!W.{- • %I.e (G-l’.j • Jhd†sT HF#U- • 70:?.p- • 70:?!Yl’"wo.d- • .>D • G/41@78J6H • A5EC<BG/ G%+-$@7 • mn-70:?.p-C‰‹
9.  
      2 2 . 01 02 03
10.  
      ? ? ? ? + 40   
11. ? ? ? ? 4 0 0
      + 4 0    !
12. ? ? ? ? 4 0 0
      +    ! 4 0 •    •    
13. ? ? ? ? 4 0 0  +  #$&  ! 4 0 • !%     • !%    '#" 
14. "% !  
     # !$   
15. +
16.     
    
     
    
       
17.            
    
        
    
      
     
    
18. 1)&.* " '-0, LINE$(/    ,5-LINE" )'1 A  9:
    LINE.8" )' LINE !# ;0+>  
    B@%!&#  1)&. 1) LINE !# ? <2 2) [
    ]LINE !#  '#73$&( 3) [(/   ] $&( 4) ;0+> %+ 6C*/= '-04 
19. #!    $ " 
     )6&(A0
    FK2,5&A+$ CNV )6&(A0$TO!
    :41/$ L_<-
    :41/URL$* >4*<-G
    :41/$ B]XP  QI4[\)6&(A0 TO  EDR!62#
    ) 6&(A0$TO   • <-ID%49@8 • *>4*>2,5&A+ • 'A9?4.=A>2,5&A+ • 3;472+     YJW
    `^YJ
    MS "HU
     Z 
20.  
      
       1.A 2.B 3.C 4. D 5. E 6. F 7. G   
     
     "! 
21.  
     &$# 
     2#   "/1 , ) 
    (0
    ) 0
    .0) 
     ) *
    , % !0-'+$ 
22. 2 2 ?4CQ
    ®p
    V„ °„«0 2 01 02 03 LINE 2 gƒk.LINE295UC t §  .   #
    LINEn‡295UC LINE "’q!dŸ
    ª£!@6A : % 1) , , LINE 0  !—w 2) [ ] , LINE "C :†0?AJ 3) [ 2 ]0 ?AJ 4) ’q!dŸ [ . ] guf"/ "_h
    LINE295UC"t § 0s.  % LINE o›‹¥a">KCI7U0Žl
    [ ][ ][ ]08 U!‹¥ ©~_h0l†\. LINE LINE295UC"t § #
    o›‹¥ !
    “¨ƒLINE295UC0
    c ¨(ƒk .+!.'"©~"  LINE295UC0t §!#
    uf"Šz" , 0ž.ˆp -% - LINE295UC!yv–¤⋅MQ2DR>⋅G> TD0¢˜. - LINE295UC!Facebook%#Apple ID0j .
    Apple ID0ƒ295UCt § #
    iOS]‰ "&Œ‚ Y‘"LINE295UC
    t § 0.'" Šz0ž. …} ©~_h0l†\. 2 ¢˜.MQ2DR>#uf"Z¦…} % 1)[ ][ ][ ]0?AJ 2)[ ][ ]0?AJ 3)MQ2DR>^e¯"f!MQ2DR> m /% 295UC†$•l MQ2DR>0¢˜ [X#, MQ2DR>0‹¥[X#, ⋅ 2 G>TD0€š…}.# %1 G>TD0­/[X#
    uf"Z¦‹¥ 
    ‹¥G>TD#­/ +!MN0 %* 1)[ ][ ][ ]0?AJ 2)[ ]0?AJ 3)cG>TD0^e[OK]0?AJ
    ¨!G><D)Touch ID
    Face ID0rb .[X#
    G>TD0‹¥.`!SA:{¡" ©~ ˆp 295UC0t §!+
    uf"B?0 •W.  % OS - ⋅;QJ - JSI3Q|x - 2QFL⋅EC"|x - ?4LO4U - >?UJ⋅” ⋅¬„™ - Keep!iœB? - LINEjl2JP⋅=H>"|x
23.    %  #! , $ ".-  &  
    ,* ) + ('
24. 83*)%=7 -6H 7>1 Y  Z O@"%$>/!`U 1. mN@Wk!"%$>/xxxx"& +* 2. ZO@mN>ZO@nY!&9.&  3. ZO@Qa\Tw7:"0;*" &+* ][!VF 4. 2*=0!lX!&9.& 4&!?0"$( % "$'# 5)gK*,#:(/CS S!iu 1. mN@Wk!"%$>/xxxx"& +* 2. PLVF>*,#:(/!&9. & 3. *,#:(/CSS!sh 4. Mq!&9.& &!=7H@ H 5)!`U 1. xxxx"&+* 2. `U!&9.& sh sh5)!Qa sh!&9.& 3. 5),#/:?c!CJ 4. 84:!VF 5. Mq!&9.&    :E2*
       C. 83*
    A6;9 I K*/-D25M1L &!GJ  5)oGIe!bVFQa v!iu 1. xxxx"&+* 2. 5)rt !&9.&  3. 5),#/:!08.' 0<. 3rt  4. Mq!&9.& 83*)%83BF> < fSZO@"%$>/"&+*DER _sh5)!d^ 1. mN@Wk!"%$>/xxxx"& +* 2. ZO@][> fSZO@ > ZOj p!&9.& E2* 83* +,83BF>< ABZO@"%$>/"&+*DER _sh!d^ 1. xxxx"&+* 2. ZO@][> ZOjp!&9.& 
25. % & $# '   )( %
    &
    $# "!  
26. "   
      /) ,&*  #!   ,!  '$ %.#- ("  
    ,+
27. 
     
     ! 
      
      
           " # &%$
28. 
     
     ! 
      
     )
     *
    $# +
     
     ,
      -
    %'& ."& / 
    ( !   " # &%$
29. 
     
     ."& ! 
     )
     *
    $# ,
      -
    %'&  
     +
     
     / 
    ( !   " # &%$
30.   
      3    3
31. '& "  %  !#    $     
32.  +0  )&-"  ($! 3! /1 ." %# '*   ,     42  2 0
33. THANK YOU 4
    DP Partner Content