documentation– tag –

設計書や仕様書をWord・Excel・MarkdownからHTMLに変えた話です。CSSをファイル内に書けば1枚で配布でき、Gitで差分も追えます。実際のサンプル画面、4形式の比較表、HTMLが向かない場面まで実務目線でまとめました。

同じAWS構成を「思いついた順に置いた図」と「ルールを決めてから描いた図」の2枚で描き比べ、何が伝わりやすさを決めているのかを具体的に分解します。