タグ

developmentとdocumentationに関するvanbraamのブックマーク (2)

  • スタートアップの現場で役立つ開発要件のまとめ方

    こんにちは。ハウスマートの高松(@t2kmt)です。 皆さんは開発要件をまとめるのにどんなフォーマットを使っていますか? 開発要件をいい感じにまとめるのって大変ですよね。 ドキュメント整備せずに開発に着手し始めてしまうと手戻り抜け漏れが出てしまいますが、一方で要件定義書をガチガチなフォーマットにするとドキュメントの作成自体の工数が増えてしまいます。 スタートアップはスピードが命。ドキュメントを書きまくって開発が進まないなんて言語道断です。 開発要件の整理はプロジェクトの成否に多大なインパクトを与えますが、ほとんどの現場では企画を考える人にフォーマットが委ねられていることが多いと思います。 今回は皆さんが快適に開発要件をまとめられるように、ハウスマートで利用している mini spec というフォーマットをご紹介します。 mini spec とは mini spec とは開発の要件をまとめる

    vanbraam
    vanbraam 2018/03/22
    "ざっくり見積もった時にタスクが一人で一週間以上かかるようなものに関しては mini spec を作成"<サービスではなくfeatureレベルのタスクに対して使うのか.(少し重過ぎる気もするが)それなら納得.だがwhyの記述は欲しい
  • なぜソースじゃなく詳細設計を欲しがるのか

    Javaを始めとするオブジェクト指向言語による開発になると、設計の手法も従来とは大きく変わる。 その結果、不要になるドキュメントが出てくる。 詳細設計のことだ。 ここでいう詳細設計とは、来コードで記述する処理を、逐一日語で書き下したものを指す。 てか、そんな物を読むくらいなら、現物のソース読めよって話だ。 だいたい、ソースに書くレベルの粒度の記述を、なんでいちいち日語なんて表記揺れも甚だしいフォーマットで書かにゃならんのだ。 何よりソースに修正が入ると、遡って詳細設計も直さないと整合性が取れなくなるので、言うなれば二重に工数を掛けることになる。 「違うよ、設計を直して実装するんだよ」というが、合理性を重んじるSEやPGという人種が、実質同じ内容を何度も書きたがるわけがない。 それに、単体テストくらいまでの段階ならともかく、開発要員が縮小される結合テスト・システムテスト以降で、そんなこ

    なぜソースじゃなく詳細設計を欲しがるのか
    vanbraam
    vanbraam 2016/11/07
    インターフェイス仕様(外部設計)書は必要だが,内部仕様(詳細設計)書はいらないだろう.UTで十分.privateメソッドのUT書くかどうかは悩み所だが,それはまた別の話;読みもしない詳細設計書書かせる為に倍の金額払うのは愚か
  • 1