ドキュメントを改善するためのはじめの一歩

LINE TECHNICAL WRINTING MEETUP Vol.8 2021.10.14 https://line.connpass.com/event/226589/ 「ドキュメントを改善するためのはじめの一歩」 株式会社ソラコム テクニカルライター 矢崎 誠 イベントレポ…

[murashit]

どこかに転記しないってのはなるほどだな

[efcl]

用語集と管理

[itokenso]

表で共有しても誰も更新しない問題

[lizy]

ストックとフローのうち、ストックはフローへのポインタを管理するだけのイメージ？

[yujimi-daifuku-2222]

用語集やプロジェクトルールなどの管理系の資料は軽視されがちなのだけど、ある程度以上の規模のプロジェクトで途中参入者を想定するなら、きちんと整備しておかないと思わぬ手戻りと長時間残業の要因になるのよね

[Magicant]

「プロセスやツールよりも個人と対話を」ってやつだ

[udofukui]

めちゃめちゃ良いです。用語集凄く重要です。

[ys0000]

用語集を作る、用語集の管理者を決める。なるほどと思った。ページの割には内容が少ないが良い知見だ。

[aikawame]

DDDをちゃんとやる時にも避けて通れないやつ。参考にしよう。

[mr_yamada]

ボクサー復帰どころか、トレーナーも辞めて、就職したのか？

[kazgeo]

デンプシーロールやカエルジャンプは出て来なかった。

[IGA-OS]

用語・表現の統一は、ライティングチームとしてする最初の活動

[ryuichi1208]

書き始めた次の一歩。良き良き~

[a-kuma3]

とても分かるけれど Slack にピン留めされても用語はいくつあるんだよ、みたいなことになりそう。ドキュメントを書く側は、申し訳ないけれど、それほど意識高くない。体裁と納期が一番大切。どうすりゃあ良いんだろう

[mohritaroh]

名前を統一するの本当に難しさある

[Shalie]

テクニカルライティングのいろはと思って読み始めたら、その前に語を明確に定義せよ、という「はじめの一歩」。語を明確に定義するのは構造的な思考が必要だから、これができるチームはそもそも優秀なんだろうな。

[yatta47]

個ッと場の定義を整えるところからって言うのは大切。

[nilab]

「LINE TECHNICAL WRINTING MEETUP Vol.8 2021.10.14 https://line.connpass.com/event/226589/」