ゼロから始めるDocs as Code - Qiita

ドキュメント書いてますか？ 突然ですが、技術ドキュメント書いてますか？ ドキュメントの内容が実際のコードと乖離してないですか？ ExcelやWrod、あるいはWikiで書かれたドキュメントが扱いにくいと思ったことはないですか？ xxxxx_20231201.xlsのような日付入りのファイルが大量にできてないですか？ 必要な時にすぐに情報に辿り着くことができてますか？迷子になってないですか？ 問題点 このようなことは現場ではよく聞く話です。「あるある」と思った人も多いのではないでしょうか。 特にウォーターフォール型の受託開発の現場では大量のドキュメントがWordやExcelで作られることも多いでしょう。それはドキュメントが正式な中間成果物として扱われるためであり、そういった成果物の検収を受ける際にWordやExcelだと「納品物として都合がいい」と、（特に非エンジニアによって）判断される傾向