開発ドキュメントを何で作成するか問題。
オフィスツール では複数人での作成,メンテナンスがしにくい、体裁の統一が難しい。
Excelは論外。Wordもちょっと。
Markdownは方言が多い、メモ書き程度なら許せるが残すドキュメントにはちょっと。等々は、AsciiDocの紹介ページに多くの記述があるので、それはさておき、何はともあれ、AsciiDocを採用してみる。
農林水産省農林水産技術会議事務局筑波産学連携支援センター 農林水産研究情報総合センター(AFFRIT) さんが公開されている
AsciiDoc文書作成入門 – Asciidocによる文書作成環境の構築
をありがたく参考にさせていただく。とりあえずここから。
https://itcweb.cc.affrc.go.jp/affrit/documents/guide/asciidoc/start
https://itcweb.cc.affrc.go.jp/affrit/_media/documents/guide/asciidoc/asciidoc-start.pdf
コメント