さてみなさん、生成AI活用されていますか？
生成AIの活用がどんどん進む中で、ドキュメントの重要性が再認識されていると思います。
そんな中、生成AIを活用した開発支援が広がり、ドキュメントの重要性もあらためて注目されています。
AWSからはKiro、GitHubからはSpec Kitのような取り組みも登場しています。
そうした中で、ドキュメントを扱う上で、新たな課題も出現しています。
とくににドキュメントの納品が求めらえがちな受託開発案件では顕著な課題かと思います。
ソフトウェア開発におけるドキュメントを考えたとき
ドキュメント体系と、ドキュメント基盤の2つの視点に分けて
考える事もできるかと思います。
ちなみにこの考え方は近い考えはありますが、必ずしも普遍的なものではなく
あくまで本発表における定義です。
本発表でいうドキュメント体系とは、それこそドキュメントの本質です。
ソフトウェア開発プロセスの中で、どのタイミングで、何を文章化し、どうコードとコラボレーションするか、という視点です。
生成AI活用時代のドキュメント運用の本質に関わる部分でもありますね。
一方でドキュメント基盤とは、ドキュメントをどのように作成・レビューし、どう閲覧し、どう配布するか、という視点です。
ドキュメント体系を支える基盤であり、技術的な側面が強い部分です。
そして本発表のスコープは、ドキュメント基盤の部分です。
私たちは7年前、従来のOffice文書ベースのドキュメントから脱却することを決意し
Markdownベースのドキュメント基盤を構築・運用してきました。
比較的ドキュメントへの要求水準が高い、大手金融3社のSIプロジェクトで800ページを超えるドキュメントを
最長7年にわたり持続的に運用してきました。
この7年の間に、多くの苦労を経験し、ノウハウを得ることができました。
本発表では、私たちが実践してきた事例とノウハウを包括的に紹介します。