はじめに

ExcelやWordで作られている設計情報は参照しにくく、メンテもしにくい。先方の事情があるならともかく開発中に参照する資料をOffice製品で作るのは避けたいところ。
今回は静的サイトジェネレーターを使って、文字ベースの仕様や用語などの情報をドキュメント化しましょう。

やりたいこと

設計書といっても種類があります。まずは比較的やりやすいと思われる「用語集」のテンプレートを作るところを目標にします。

色々あるようですが以下のような理由でhugoを採用。

この辺まで調べてチャレンジすることに決定。

次回は使ってみた編。