magnoliak https://blog.hatena.ne.jp/magnoliak/ Magnolia Tech https://blog.magnolia.tech/ ドキュメント書くのが面倒だっていう問題、コードを書く前に書かれるドキュメントがその目的がコードを適切に書かせるためだとすると、その後の維持メンテで必要かつ最小限の範囲からすると必ず過剰になっちゃうんだよねコードできあがると「コード読めばいいじゃん」って部分まで残るから— magnoliak🍧 (@magnolia_k_) 2021年11月11日 でも検討の経緯とかは残ってほしくて、でもそのためにわざわざまたドキュメントの全体構造を見直すこともできないしっていう— magnoliak🍧 (@magnolia_k_) 2021年11月11日 コードの複雑さを分かりやすく要約して理解しやすくする為に… 190 <iframe src="https://hatenablog-parts.com/embed?url=https%3A%2F%2Fblog.magnolia.tech%2Fentry%2F2021%2F11%2F13%2F181203" title="ドキュメントを書いて維持するのが何故こんなに大変なのか - Magnolia Tech" class="embed-card embed-blogcard" scrolling="no" frameborder="0" style="display: block; width: 100%; height: 190px; max-width: 500px; margin: 10px 0px;"></iframe> Hatena Blog https://hatena.blog 2021-11-13 18:12:03 rich https://blog.magnolia.tech/entry/2021/11/13/181203 1.0 100%