20231206_設計ドキュメント腐る問題、Git管理で運用してみた本当のところ

設計ドキュメント腐る問題、 Git管理で運用してみた 本当のところ 2023.12.5 真野隼記 ドキュメント管理を制する 陳腐化を防ぐための実践事例 Lunch LT

[Sephy]

運用ルールの問題だと思う。ドキュメントとセットじゃないとレビュー通さないようにするか、チケット管理でコードとドキュメントの子チケット完了しないと親チケットを閉じれないようにするだけ

[kuippa]

AIがコードからクラス関係図やら機能書き出しやらもぜーんぶ自動更新してくれる未来がほどなくくるだろうからそれまで寝てるよ・・・。

[hogeaegxa]

迫りくる納期を前に、リスケや残業をしてでもドキュメント書かせるようなオーナーシップ取るってのは、もう平や課長程度の権力で出来るもんじゃないよなあ。

[moriso]

腐らせないためには個人所有→共同所有に意識を変える

[vegnpomn]

プロジェクトがずっと炎上せず安定していればいいが、炎上し始めた時にドキュメントドキュメント言ってると、発達障害扱いされてメンバーにボロクソに叩かれる未来しか見えない。ちょっとその役はやりたくないな

[kiki-maru]

永遠に同じメンバーで運用するなら運用で何とかなるけど、人が変わればあっという間に優先事項が変わるからいつか腐ります。

[aktkro]

更新を担保することだけに重きを置くなら、ドキュメント更新しないとレビュー依頼受けつけないルールにすればいいと思う。ただ、ドキュメントの更新範囲を見落としたりするだろうから完璧は無理。

[alpon]

顧客用に別のパワポ作って説明するのもいかんと思うのよね。案レベルでも最初から設計書ファイルをいじって説明すればいいのよ。

[strawberryhunter]

結局、工数を使ってドキュメントを維持するという話。良くも悪くも工数を使えば当然ドキュメントは維持できる。gitかどうかなんて些末な話だった。

[nakamura-kenichi]

まあ先ずはMS Office＋チャットツールから脱却出来るかやからなあｗ。

[canadie]

書式をMarkdownにして（納品用はPDFやHTMLに変換）Git管理、定期的にAIチェックを入れるようにしたらだいぶ腐らなくなった。AIがドキュメントを読めるようになって、設計書をExcelで作る時代は終わったと思う。

[tettekete37564]

スマホじゃ見づらいので後で見る

[sgo2]

相互にリンク出来る機能が欲しい