伝わるドキュメントの作成ノウハウ大公開!! #DevReljp # 76 公式ツイートまとめ
- beajourneyman
- 3329
- 18
- 0
- 0
#DevRelJP 今回はなかなかの離職済み率の高さですw
2022-07-06 19:37:23オンライン組、オフライン組混合で進むの面白いな。 コントロール大変そうだけど。 #devreljp #devrel
2022-07-06 19:39:08#DevRelJP コミュニティイベントは失敗し放題w
2022-07-06 19:40:53書く前に立ち止まって考えよう!「伝える情報を整理する」ということ by 和氣さん(代打登壇)/仲田さん
セッション1つ目 サイボウズ 和氣さん(急遽代行) #devreljp #devrel pic.twitter.com/z3dwzCRbtN
2022-07-06 19:41:41ドキュメントは読んでくれる人のためのモノ。 当たり前だけど大事なキーワードだなあ。 #devreljp #devrel
2022-07-06 19:45:09最初のセッションは @waku_ter さんより〜 #DevRel #DevReljp pic.twitter.com/uUikgAwBH6
2022-07-06 19:42:13DevRel Meetupオフライン会場に参加しましたー!テクニカルライティング特集ということで気になる話です。 ハイブリッド配信環境すごい! devrel.connpass.com/event/250808/ #DevReljp pic.twitter.com/5LubzErSkT
2022-07-06 19:42:23#DevRelJP わけさん(代打)製品のマニュアルを書くお仕事 なかたさん サイボウズ製品のUIテキストを書くお仕事 テクニカルライティングってなに 情報を分解して整理する話 pic.twitter.com/L7UjxSAx8U
2022-07-06 19:42:54代打素晴らしい👏 #devrel #devreljp pic.twitter.com/ZUy8Bf3Trz
2022-07-06 19:43:01最初のセッションは、サイボウズの仲田尚央 (@naoh_nak) さんの資料をベースに和氣さんが「書く前に立ち止まって考えよう!「伝える情報を整理する」ということ」について発表いたします🎙 #DevRel #DevReljp
2022-07-06 19:43:29定義からしていただけて助かる。 #devreljp #devrel pic.twitter.com/qKlER7l8TC
2022-07-06 19:43:32📝テクニカルライティングの適用対象例 ✅議事録 ✅報告書 ✅技術書・解説書 ✅仕様書 ✅マニュアル/FAQ などなど #DevRel #DevReljp #エンジニア #ドキュメント #スキル
2022-07-06 19:44:55この観点大事だなー 読む人も、書く人も(質問される時間も減らせる)。 #DevRel #DevReljp pic.twitter.com/Aq0Uv0otOj
2022-07-06 19:44:58#DevRelJP 読者・目的に合わせて技術をわかりやすく伝える技術 ドキュメントは多くの人に読まれる 分かりやすければ業務の時間が節約できる 書き方わかってれば書く側も短時間でまとめられる 重要 pic.twitter.com/PGl7Oxw9iw
2022-07-06 19:45:00最初のセッションは @waku_ter さん!ピンチヒッターとは思えないセッション(´Д` )!! こういうオフラインっぽい写真も久々ですね。 #DevRelJP #DevRel pic.twitter.com/Svn8awLIsw
2022-07-06 19:45:51#DevReljp お一人目をサイボウズの和気さんから「書く前に立ち止まって考えよう!「伝える情報を整理する」ということ」についてです。
2022-07-06 19:47:45#devreljp #devrel pic.twitter.com/83PtSI1TvZ
2022-07-06 19:48:02#DevRelJP 書くにあたって意識すべき前提条件 ①読む人のレベルがさまざまで情報もさまざま 読者のニーズの把握が必要 ②探し方も違う 書く場所・配置も考える ③情報が一意に伝わる必要がある 書き手と読み手で同じものをイメージできるように ④一部しか読まれない 優先度の設計 pic.twitter.com/vqnrcmu3Jq
2022-07-06 19:48:06一部しか読まれない、はあるあるなんんだけど辛いよね…質問されて、それ書いてるのにってことはよくある。 #DevRel #DevReljp
2022-07-06 19:48:41#devreljp #devrel pic.twitter.com/x1YmF9lr3L
2022-07-06 19:48:51#DevReljp テクニカルライティングはユーザビリティの高いドキュメントを書くというコト シンプルだけど本質的ですね
2022-07-06 19:49:34「一部しか読まない」と合わせて考えると結構難しい #devreljp #devrel pic.twitter.com/4Th452HkiN
2022-07-06 19:49:50テクニカルライティングの要素の1つ Satisfaction 不快さがなく、肯定的に受け止められる 確かにこれめっちゃ大事な気がする #DevReljp
2022-07-06 19:49:55