企画書なら、 目的 目標 手段 #Forkwell_Library

途中参加でしたがありがとうございました！！ #Forkwell_Library

箇条書きから文章にするのって一山超えなきゃいけない感じがしますね。 まとまりや順番や接続詞を意識するのがいいのでしょうか。 #Forkwell_Library

フロー情報とストック情報 #Forkwell_Library

ドキュメント作成tips 情報はニーズの大きそうなものから順に並べるのがいい。 内容が分厚いものは分割、薄いものは結合させる。 見出しを見るだけでわかるようにする。 構造を整えて後から修正しやすくする。 #Forkwell_Library

文章の感じが人によってバラついちゃう→『日本語スタイルガイド』を読む #Forkwell_Library

テクニカルライティング試験の教科書にもなってますね。 日本語スタイルガイド（第3版） jtca.org/learn-tc/publi… #Forkwell_Library

情報を分解して整理 階層構造を持つ #Forkwell_Library

ユーザビリティが高い文章を書くための要素 #Forkwell_Library

#Forkwell_Library ドキュメントを書く際に、読み手はある程度絞らないと駄目ですよね。全員に分かりやすいドキュメントを作るのは難しい

一文を短くするけど、つなげるとぶつ切り感が出ちゃうの、わかるーーー #Forkwell_Library

告知されてるイベントのメンツ、強すぎるだろ。 #Forkwell_Library

やっぱり白米は最強!!!! #Forkwell_Library

既知から未知へと文章構成を取るのよいかも #Forkwell_Library

1. 要素を書く 2. 要素をピックアップ 3. 見出しを考える 4. 見出しを通しで見る 機能の説明→機能の目的 と言う流れの方がわかりやすい #Forkwell_Library

綺麗にドキュメントまとめられてもユーザが知りたいことからズレていたら意味がない。ユーザは基本的にドキュメント読みたくないから最小限読むだけでわかるようにするのがベスト！ 例：知りたいこと どんなことができるか→機能の一覧 具体的な機能の操作→操作手順 #Forkwell_Library

分割してくのは大切 分割粒度が適切かどうかってとこは毎回悩むけど #Forkwell_Library

マニュアル頭から全部読まないといけないのつらいもんな… 時間あるときならともかく急いでる時に全部読んでられないし💦 #Forkwell_Library

目次から書くの結構大事。。！ #Forkwell_Library

種類は違うが、執筆中のワイにとって参考になる。 #Forkwell_Library

「エンジニアは好きでドキュメントを読んでいるわけではない」 …ごめんなさい。新製品を購入すると紙の分厚いドキュメントを舐めるように読むのが好きでした。最近はPDFやWebで説明書が代替されるため、物足りなさを感じています。 😅 #Forkwell_Library

正確に受け止めてもらえる文章って難しい気がする 思わぬところでひっかかって意図しない受け取り方をされてしまったりする😓 #Forkwell_Library

ドキュメント作成の特徴 1. ドキュメントの目的達成 2. 情報の正確性 3. 情報の効率化 →どこに何が書いてるか分かりやすく 「目的に応じた情報を効率よく、正しく伝える」 #Forkwell_Library

子どもがぐるナイスペシャル見てる隙にイン!!🥹 #Forkwell_Library

ドキュメントもいきなり書くとダメで、 「読み手とテーマの選定」をしてから「構成を考える」と確かに上手く書けそう #Forkwell_Library

ドキュメントも設計が大事 #Forkwell_Library

業務に役立つドキュメントになっているかどうかは微妙ですが、エッセー、雑文、お気持ちを書き綴るのは大好きです。読みやすいか？理解しやすいかは別にして仕事の気づきを職場の掲示板に長々と書き残しています。😅　高校生の頃の憧れは寺田寅彦でした！🥰 #Forkwell_Library

エンジニアが一生困らない ドキュメント作成の基本 - Forkwell Library#73 forkwell.connpass.com/event/334408/ #Forkwell_Library

👼の声が聞こえて高評価押した。 #Forkwell_Library

わかってもらうためのドキュメントを書くのは好きだが、わかってもらうためのドキュメントを書くのは難しい。 #Forkwell_Library

書くお仕事メインだとどういう仕事になるんだろう。。 #Forkwell_Library

最近テクニカルライターの募集結構見かける印象ある 新卒の頃にちょっと考えたけど募集自体が少なかったんよね💦 #Forkwell_Library

皆さんは、なぜドキュメントを読み、 ドキュメントを書くのでしょうか？ #Forkwell_Library

ドキュメント作成やる事になるだろうから見てる…！ #Forkwell_Library

in! エンジニアが一生困らない ドキュメント作成の基本 - Forkwell Library #Forkwell_Library pic.x.com/5h3SkDh9eZ

みてる #Forkwell_Library

はじまった！ | エンジニアが一生困らない ドキュメント作成の基本 - Forkwell Library#73 forkwell.connpass.com/event/334408/ #Forkwell_Library

質問の投稿はこちらからお願いします🙌 slido.com/Forkwell_Libra… #Forkwell_Library

もうちょいであじまる #Forkwell_Library