Kazuho's Weblog: 良いソフトウェアに求められる３点セットとJSXの開発手法の改善とgit-pushdirについて

テスト駆動開発（TDD）の一般化とGitHubの登場によって、機能追加の際にコードとテストを同時に実装する（そして、両者を一括してmasterにmergeする）という開発手法が一般化してきました。 しかし、「良いプログラム」の要素を構成するのは、コードとテストのみではありません。動作するコードと、その品質を担保するためのテストがあったとしても、適切なドキュメントがなければ、ユーザーはそのプログラムをどうやって使ったら良いかわかりません。 つまり、ユーザーに使いやすいプログラムを継続的に開発／提供しようと思うと、 コード テスト ドキュメント の３点セットを提供する必要があるのです注1。 今日のJSXが抱えている最大の課題は、ドキュメントが不足しているという点にあります。その原因は、「機能追加」の際にコードとテストのみを実装してmasterにmergeすることを繰り返す一方で、ドキュメントは

[legoboku]

「 ユーザーに使いやすいプログラムを継続的に開発／提供しようと思うと、コードテストドキュメントの３点セットを提供する必要がある」

[taketyan]

これは本当にそう思う / コードとドキュメントのリポジトリを一緒にすることで、タグ指定するだけで特定のバージョン時点での仕様とかも確認できるようになる、という利点も

[kasumani]

良いソフトウェアに求められる３点セットとJSXの開発手法の改善とgit-pushdirについて テスト駆動開発（TDD）の一般化とGitHubの登場によって、機能追加の際にコードとテストを同時に実装する（そして、両者を一括してmasterに

[Layzie]

まさか注釈で自分のブログの記事が出てると思わなかったのでビビった。git-pushdir試してみたい。

[yass]

" プルリクエストはコード／テスト／ドキュメントの３点セットで構成すること / そのために、すべてのドキュメントをレポジトリ本体の一部として管理すること "

[t-wada]

“ユーザーに使いやすいプログラムを継続的に開発／提供しようと思うと、 1.コード 2.テスト 3.ドキュメント の３点セットを提供する必要がある” ドキュメントが別リポジトリだと開発時に更新されにくい問題

[karupanerura]

git-pushdir

[yosuke_furukawa]

JSX ドキュメント問題にさっそうと現れる git-pushdir

[gfx]

“つまり、ユーザーに使いやすいプログラムを継続的に開発／提供しようと思うと、 コード テスト ドキュメント の３点セットを提供する必要があるのです”

[mitsugusakamoto]

これ某あそこに読ませてやりたい文章だと思った。>3点セット

[sonots]

ドキュメント書きましょう

[teppeis]

「JSXでは今後、プロジェクトページを含む全てのドキュメントをJSX本体のレポジトリで管理」すばらしい。

[kazuhooku]

blogged