DevRel Meetup in Tokyo #3での資料です。 http://devrel.connpass.com/event/20190/

1. （株）MOONGIFT 中津川篤司
書く技術

2. 自己紹介
@a_nakatsugawa
fb.me/moongift
株式会社MOONGIFT 代表取締役
2004年1月よりオープンソース・ソフトウェアを毎
日紹介するブログ MOONGIFT を運営。
http://www.moongift.jp/
中津川 篤司
@moongift fb.me/moongift.fan

3. 結論
上達したければ書くべし、
書くべし、書くべし！

4. MOONGIFTの執筆量
ソフトウェア紹介 1,100文字 60記事＝66,000文字
プレミアム限定 800文字 8記事＝4,800文字
DevRel用 1800文字 40記事＝72,000文字
その他 2,000文字 2記事＝4,000文字
146,800文字/月

5. 書く対象
• ブログ
• 仕様書
• ヘルプ
• 報告書/論文
• メディアへの寄稿/書籍

6. 読みやすさ

7. 読みやすい文章とは？
• 話すように書く
• 書きたいように書くではなく読みやすいように書く
• 囲い込みではなく誘導
• 句読点、一文の長さに気を遣う
• 漢字を使いすぎない

8. Webブラウザー（IE/Firefox/Google
Chrome/SafariなどHTML5対応である
事）にて当該URLを開き、表示された従
業員ログイン画面にて従業員番号および
パスワードを入力後、ログインボタンを
押下する。そうすると認証処理が実行さ
れ、成功時には従業員向けインデックス
画面が、失敗時には失敗に至った原因及
び再度従業員ログイン画面が表示される
事とする。

9. Webブラウザでログインします。

10. 読み手のことを考える

11. 分かりづらいプレゼン

12. 分かりやすいプレゼン

13. 囲い込みではなく誘導

14. ○○しなければならない
○○とする
○○である
お前らに選択の自由はない

16. 読み手を誘導する

17. 句読点、一文の長さ

18. それでは今回はドキュメントAAAの第2章に
沿って進めていきますが、特に注意して欲し
いのが第3項にある「ユーザ特性に関する注
意」になり、この項においては佐々木主任の
指示を仰いだ上で開発に入っていただきたい
内容になり、くれぐれも単独で開発に入るよ
うなことのないよう注意し、かつ他の協力会
社の方々に対しても周知徹底していただきた
い重要ポイントになりますのでよろしくお願
いいたします。

20. 今回はドキュメントAAAの第2章に沿って進
めていきます。
特に注意して欲しいのが第3項にある「ユー
ザ特性に関する注意」で、ここは佐々木主任
の指示を仰いだ上で開発に入ってください。
他の協力会社の方々に含め、単独で開発に入
ることのないよう周知徹底してください。

21. 句読点
この、ソフトウェアのポイントは、持続性、
安全性、そして改変が自由に、また公開につ
いても自由に選択できる、そんなところにあ
ります。

22. このソフトウェアのポイントは持続性、安全
性そして改変が自由に、また公開についても
自由に選択できるところにあります。

23. 漢字を使いすぎない
無い→ない
有る→ある
事→こと
尚→なお
為→ため
物→もの
時→とき
出来る→できる
言う→いう
http://hajimeteweb.jp/column/web_writing/special2.php
居る→いる
余り→あまり
如何に→いかに
何時→いつ
致す→いたす
概ね→おおむね

24. 同じ単語を繰り返さない
このシステムは従業員向けのシステムです。
このシステムで保存ボタンを押すとデータが
保存される仕組みです。
このシステムによりこれまでの20%作業効率
が向上されることが期待されます。
右側にあるボタンからシステムに関する
フィードバックが行える仕組みです。

25. 文章構成
• ブログ
起承転結または起転承結
• 論文や報告書（海外のブログ）
結起承転

26. お勧めの学習法
• 小説を読みましょう（ラノベ除く）
• 普段から書く習慣をつけましょう
• 短く書く癖をつけましょう
• 正確であることよりも理解される文
章を心がけましょう

27. 結論
上達したければ書くべし、
書くべし、書くべし！

28. ご静聴ありがとう
ございました