HTML による説明ドキュメント

文章

説明内容と日本語表現を補うため、次のスキルの併用を推奨する。

• explain：概念や仕組みを説明するときの用語定義、説明の粒度、構成
• japanese-tech-writing：日本語の技術文書、記事、解説文の構成と文章規範
• cognitive-rhythm-writing：読み物としての緩急が必要な長文の文章規範

いずれも推奨スキルであり、html の必須依存ではない。

成果物

• HTML を作る
• ビルドなしでブラウザが直接描画できる状態にする
• 保存先が指定されている場合は従う。指定がなければ現在の作業ディレクトリへ保存する
• ファイル名は {yyyymmdd}-{内容を表すケバブケース}.html とする。既存ファイルの更新では名前を変えない
• 個別の文書管理システム、メタデータ、Viewer、公開先に関する規則は、このスキルを参照する上位スキルの指示に従う