2023-04-19

Wiki とかのコメント機能でドキュメントをアップデートする

こちらのセミナーは先日参加していて、改めて資料を読み直した。

読み手を理解してより良いドキュメントを書こう
https://speakerdeck.com/line_d...

こんなかんじでフィードバックもらえる機会は少ないような気はするけど、、、、

ドキュメントが読まれていなかったり、書いてあっても伝わっていなかったり、見つけられなかったり。
質問・問い合わせとしてフィードバックの機会はあるわけだから、それはそれで活かしつつ。

Wiki や Docbase みたいなドキュメントにコメントって必要なのかなぁ、とおもっていたけどドキュメント自体についての質問とかはそのコメントでやりとりすればドキュメント自体のアップデートにも繫がっていくのかもな、と思った。