-
ドキュメント
ドキュメント
Blog
技術ドキュメント問題の全体地図——AIコーディング時代に何が起きているか【まとめ】
執筆者:DigKnow株式会社 CTO 桑原 脩 ここまで、技術ドキュメントについて何本も記事を書いてきました。書いては消し、現場の話を聞いては書き直す——その
コードが自分を説明できる世界——「セルフドキュメンティングコード」の限界と未来
執筆者:DigKnow株式会社 CTO 桑原 脩 「良いコードにコメントはいらない。コードそのものが仕様書だ」——シニアエンジニアなら、一度はこの言葉に頷いたこ
10年後、システムを読める人は何人残るか——AIコーディング時代の盲点
執筆者:DigKnow株式会社 CTO 桑原 脩 10年前にローンチされたシステムが、いまも会社の売上の中心にある——そんな現場は、思っているより多いはずです。
フローチャート・シーケンス図・ER図——誰のために書くドキュメントか
執筆者:DigKnow株式会社 CTO 桑原 脩 リポジトリの`docs/`配下や、Confluenceの片隅に、誰も開かなくなったフローチャートのPDFが眠っ
2025年の「仕様書」はコードから読み取るべきか——AI時代の前提崩壊
執筆者:DigKnow株式会社 CTO 桑原 脩 「ドキュメントは嘘をつくが、コードは嘘をつかない」——シニアエンジニアなら、一度は口にしたか、聞いたことがある
ドキュメントツールを導入したのに誰も書かない——失敗する本質的な理由
執筆者:DigKnow株式会社 CTO 桑原 脩 「今度こそちゃんと書こう」と言って、ドキュメントツールを導入します。最初の一ヶ月は活気があり、テンプレートが整
仕様書が揃わないのは、なぜ時間ができても解決しないのか
執筆者:DigKnow株式会社 CTO 桑原 脩 仕様書がチームで揃わない、最新版がどこにあるか誰も知らない、書いたはずのドキュメントが古いまま放置されている—