■ - 日々精進

技術文書のLintツール。ドキュメント作成にソフトウェア開発の手法を取り入れるというのは面白そう。

Markdownで文書を書いて、Gitでバージョン管理して、textlintで自動チェックして、お客さんに出す時はGitBookでPDFにして出すのやってみたい。

自動テストもやりたいけど、やるなら普通のドキュメントじゃなくてCucumberとか使って自然言語でテストシナリオを書いて、それを仕様書にするというアプローチになりそう。そういう手法はspecification by exampleという本で紹介されている。