読者です 読者をやめる 読者になる 読者になる

日々精進

新しく学んだことを書き留めていきます

IT

efcl.info

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

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

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

Specification by Example: How Successful Teams Deliver the Right Software

Specification by Example: How Successful Teams Deliver the Right Software