Writing skills for Information Technology

# IT 人一定要知道的寫作技巧
　
藉由多年來在 Blog 和 IT 鐵人賽的寫作經驗，向 Microsoft Taiwan 的實習生們，分享凍仁在撰寫技術文章時，所用到的一些寫作技巧。
　
#Writing #IT

Transcript

1. _______________________ < IT ⼈人⼀一定要知道的寫作技巧 > ----------------------- \ \ [ chusiang@MicrosoftTaiwan ~ ] $ cat .profile # Author: 凍仁翔 # Email: chusiang@drx.tw # Blog: http://note.drx.tw # Date: 2017-01-21 10:00 `.-:. `.. ```.-://++oooo+/:-.ss.+o:` /so++/:-..` ``.` :yshs. ds/.. ``.--+yh+ .+oo:: ```````` ``:shhh `:yo::. `` `` ``/yho/d- `yo+:: ```````-ohh/`.ys `/ys-:````````./yhs-`.`+d -so/:- `````-oyh+....`-d: `so+:/`````.:os:.`````.oy `/so-/-````--.`````````:m` .ys/::```-............-h/ `oo+-/```````..--::/+osd- .ydy::/+oosyhddmmNNMmdhy`
2. 關於我 • 凍仁翔 (@chusiang_lai)。 • DevOps ⿊黑⼿手技師。 • DevOps Taiwan 志⼯工。 • 6 年年 IT 維運經驗。 2
5. Outline 1. IT ⼈人是什什麼？ 5
6. Outline 1. IT ⼈人是什什麼？ 2. 常⾒見見的寫作技巧有哪些？ 6
7. Outline 1. IT ⼈人是什什麼？ 2. 常⾒見見的寫作技巧有哪些？ 3. 凍仁都怎麼寫⽂文章？ 7
8. Ⅰ. IT ⼈人是什什麼？ 8
10. 網路路 Networking 資料庫 Database 程式 Programming 10
11. ※ 此圖出⾃自 Chen Cheng-Wei 的 Effective DevOps 簡報 (https://www.slideshare.net/warfan/effective-devops-78979993)。
12. 三步⼯工作法 Flow、Feedback、Culture。 《The Phoenix Project》 Amazon - https://goo.gl/visckK 12
13. 四種⼯工作類型 業務⼯工作、IT 內部⼯工作 、變更更⼯工作、例例外⼯工作。 《The Phoenix Project》 天瓏網路路書店 - https://goo.gl/bRUHq6 13
14. 我的★路路歷程？
15. http://www.angelfire.com/ok/leekawo/hacker.htm 2008 Start 15
17. Blogger http://note.drx.tw/2008/03/fontscwtex-ttf.html 2008 17
18. Kaohsiung Linux User Group http://kalug.linux.org.tw 2008 18
19. Conference for Open Source Coders, Users and Promoters 2008 http://coscup.org/2008/ 19
20. http://note.drx.tw/p/about.html 2012 Blogger v2 2008 20
21. https://ithelp.ithome.com.tw/articles/10138621 ironman 6th 2013 2008 21
22. https://www.gitbook.com/book/chusiang/working-on-gnu-linux/details 2015 GitBook 2008 22
23. https://ithelp.ithome.com.tw/users/20031776/ironman/1022 2017 ironman 8th 2008 23
24. 2008 Start 2018 Writing skills for IT 24
25. Ⅱ. 常⾒見見的寫作技巧 有哪些？ 25
26. 起承 轉合 26
28. 主題、感動 起 28
29. 起 29
30. 他⼈人的觀點 承 30
31. 承
32. ⾃自⼰己的觀點 轉 32
33. 轉
34. 收尾、結論 合 34
35. 合
36. 圖⽂文穿插圖⽂文穿插 圖⽂文穿插　　　　　　 圖⽂文穿插 圖⽂文穿插 圖⽂文穿插圖⽂文穿插 圖 36
37. Code Block # Debian, Ubuntu. $ sudo apt install ansible # RHEL, CentOS. $ sudo yum install ansible # Mac OS X. $ brew install ansible 37
38. Note Block 38
39. Reference Block 39
40. 動態 > 靜態 40
41. 動畫 影片 圖片 > 41
43. 相關連結 資料來來源 參參考⽂文獻 撰⽂文時，曾參參照的 有效⽂文章、簡報 活動連結、 範例例程式碼 43
44. 創⽤用 CC 授權條款 > https://creativecommons.org/licenses/by-nc-sa/2.0/tw/ 姓名標⽰示 非商業性 相同⽅方式分享 44
46. Ⅲ. 凍仁都怎麼寫⽂文章？ 46
47. 凍仁的寫作技巧？ 47
48. ⼼心智圖 48
50. ※ 此⾴頁出⾃自 Ruddy Lee 老師的 DevOps 的敏捷化思維簡報 (https://goo.gl/Qekjua)。 50
51. 短篇 × n 長 篇 > 51
52. 回饋 52
53. 天下武功 唯 不破 快 53
54. 我們 你 > 54
55. 綴詞 ↓ 55
56. 怎麼減少綴詞？ 唸 56
57. 表情符號 ↓ 57
58. ㄓ ㄨˋ ㄧ ㄣ ⽂文 注 ⾳音 ╳ 58
59. (使⽤用第三⼈人稱) 59
60. 縮排 標點符號 & 60
61. - https:/ /goo.gl/8tb4dR 61
62. - https:/ /goo.gl/r2W3K4 62
63. 寫作⼯工具箱 63
64. Mind Map 64
65. SimpleMind 65
66. FreeMind 66
67. Markdown HTML Syntax Blogger GitHub, GitBook, Jupyter 67
68. - https:/ /goo.gl/32KnHG 68
69. - https:/ /goo.gl/yhrz1w 69
70. Text Editor MacDown Vim VS Code 70
71. Photo LICEcap Skitch Shutter 71
72. Video QuickTime iMove LICEcap 72
73. 案例例分析 73
74. ⽇日誌 http://note.drx.tw/2017/09/the-firewalld-on-centos-7.html 74
75. 系列列⽂文章 1 https://www.gitbook.com/book/chusiang/working-on-gnu-linux/details 75
76. 系列列⽂文章 2 https://ithelp.ithome.com.tw/articles/10128621 76
77. 系列列⽂文章 3 https://www.gitbook.com/book/chusiang/working-on-gnu-linux/details 77
78. ⼈人 事 物 時 地 78
79. 作者、對象 ⼈人 79
80. 事件、⽬目標 事 80
81. 時間、⽇日期 時 81
82. 場地、環境 地 82
83. ⼯工具、設備 物 83
84. 教授他⼈人 / 立即運⽤用 90% 實作演練 75% ⼩小組討論 50% ⽰示範 / 展⽰示 30% 視聽 20% 閱讀 10% 學習⾦金金字塔 被 動 學 習 主 動 學 習 聽講 5% 84
85. 學習⾦金金字塔 聽講 閱讀 視聽 ⽰示範 / 展⽰示 ⼩小組討論 實作演練 教授他⼈人 / 立即運⽤用 5% 10% 20% 30% 50% 75% 90% 被 動 學 習 主 動 學 習 寫作 85
86. 今天提到了了什什麼 ？ 86
87. 網路路 Networking 資料庫 Database 程式 Programming 87
88. http://www.angelfire.com/ok/leekawo/hacker.htm 2008 Start 88
89. ※ 此⾴頁出⾃自 Ruddy Lee 老師的 DevOps 的敏捷化思維簡報 (https://goo.gl/Qekjua)。 89
90. 起承 轉合 90
91. 回饋 91
92. 天下武功 唯 不破 快 92
93. ⼈人 事 物 時 地 93
94. 教授他⼈人 / 立即運⽤用 90% 實作演練 75% ⼩小組討論 50% ⽰示範 / 展⽰示 30% 視聽 20% 閱讀 10% 學習⾦金金字塔 被 動 學 習 主 動 學 習 聽講 5% 94
95. 今天提的 DevOps 是什什麼？ 95
96. Q & A 嚴禁拍打餵食 96
97. - Atul Gawande，《開⼑刀房裡的沈沈思》#學徒模式 「你不應該低估寫作的⼒力力量量 … 你會忘記⽬目的。 但寫下來來會讓你後退⼀一步，重新思考⼀一個問題， 即使是最憤怒的怒吼，也能強迫作者達到 ⼀一定程度的深思熟慮。」 97
98. 參參考⽂文獻 • DevOps 的敏捷化思維 by Ruddy Lee
 - https://goo.gl/Qekjua • DevOps 的敏捷化思維 - Glossary by Ruddy Lee
 - https://goo.gl/h8uLQm • 提到 DevOps 到底在談些什什麼玩意兒？ by Chen Cheng-Wei
 - https://goo.gl/7YTeKD 98
99. 圖片來來源 • MacBook Pro x HHKB Pro2 by Kang-Min Wang | Flickr
 - https://www.flickr.com/photos/lagunawang/ 28061345150/in/album-72157670433063021/ • notebook, writing, pencil | PxHere
 - https://pxhere.com/en/photo/485922 99
100. https://t.me/devopstw https://www.facebook.com/groups/DevOpsTaiwan/ https://devopstw.club/ DevOps Taiwan 100
101. Ansible Taiwan https://t.me/ansible_tw https://github.com/ansible-tw http://ansible.tw 101
102. http://萍⽔水相逢.tw 102
103. END 103