ドキュメント駆動開発v2

前提 ここで言っているドキュメントは仕様書ではなく、顧客向け製品ドキュメント。 ミドルウェア製品を開発 小さなチーム パッケージ製品とパッケージ製品のクラウド版 そのため顧客に提供するドキュメントが必ず必要 GitHub を利用 自分で開発する場合のフロー 作りたい機能をぼんやりでいいので GitHub Issue に追加する feature ブランチを切る デザインドキュメントをリポジトリの doc/ 以下に書く デザインドキュメントに合わせてコーディングを進めてなんとなく動くところまで作る 動かなくてもいいのでイメージを膨らませるためにコードを書いてみる デザインドキュメントは書き捨て前提で、とにかくメモを書く 製品ドキュメントを書き始めて、一旦書き終える ブランチマージに向けてコーディングを進める 書ける範囲でテストを書く ドキュメントを平行して修正する プルリクエストをだしてレビュ

[jsoizo]

どこまでドキュメント"駆動"するかはさておき、ドキュメントをリポジトリの中に含めるのは賛成。マイクロサービスごとにリポジトリが切られていたりなんかすると割とマッチする。

[kkeisuke]

“ドキュメントとコードを行き来することで設計が整理されていく”

[ys0000]

普通の設計書書いてから実装するウォーターフロー的なアプローチの話かと思ったら違った。でも印象としてはそんなに違わない／先に仕様作ると変化に弱いって話もある訳で、どの辺まで作るのかはバランスなのかねぇ。

[yumura_s]

よきよき。“ドキュメントとコードを行き来”できている事が肝要かなぁ。ウォータフォールかつ設計と開発を分業している場合、この行き来のコストがめちゃくちゃ高い。それがローコストでできる組織は単純に強そう

[kobito19]

ファッションと同じやな。昔の流行りのリバイバル。

[hdkINO33]

“機能を思い出しながらドキュメントを書くのは辛い / 開発中が一番その機能を理解している” ほんとこれ / Amazonの「プレスリリースから作る」に近いのでは？ https://news.mynavi.jp/article/svalley-391/

[kenzy_n]

その駆動力が欲しい

[koogawa]

DDDだ

[mactkg]

https://agilemanifesto.org も "while there is value in the items on the right, we value the items on the left more." って言ってるんだよ ;)

[daaaaaai]

“reStructuredText ”

[nilab]

「なぜ開発と平行して製品ドキュメントを書くのか」

[hennamanao]

普通じゃんって思った

[shag]

リポジトリ内の doc にドキュメント置くのか。

[saikyo_tongaricorn]

結局駆動しなくなるんだよなぁ…

[Shinwiki]

ふつうのことのように感じた。推進力が不足しそう。

[bouzuya]

リポジトリに入る点や開発フローに組み込まれている点で良いと思う。ただ、どういうドキュメントなのかは分からないけど、変更時に放置されそう。