タグ

開発とprogrammingに関するkrogueのブックマーク (4)

  • HowToWriteAnEffectiveDesignDocument - 設計文書のうまい書き方

    HowToWriteAnEffectiveDesignDocument - 設計文書のうまい書き方 目次 この文書について 設計文書のうまい書き方 なぜ設計文書を書くのか 良い設計とは何か 同僚の開発者に向けて書く 第 1 節に書くこと: プロジェクト/サブシステムの目的を示す 第 2 節に書くこと: 設計に使う高レベルなエンティティを定義する 第 3 節に書くこと: 個々のエンティティに関する低レベルの設計を書く 使い方 設定 モデル 相互作用 第 4 節に書くこと: 利点, 前提, リスク/懸念事項 マネージャ向けに書くこと 最後に 設計文書のうまい書き方 この文書について "How to Write an Effective Design Document" の日語訳です. http://blog.slickedit.com/?p=43 推敲歓迎: 誤訳, タイポ, 訳語の不統一,

  • ソフトウェア開発やプログラミングのスピードを上げる方法はありませんか?…

    ソフトウェア開発やプログラミングのスピードを上げる方法はありませんか? プログラマーとして生きていこうと決めたのですが、いつも見積もりの3倍時間がかかってしまいます。 そのため いつもつらい思いをしています。 環境を良くしようとHHKLite2を使い、カスタマイズソフトでホームポジションから離さずにプログラミングしています。 マウスもゲーム用の高精度のものを使っています。 調べ物にもタブブラウザを使い、拡張し続けて効率化をしています。 DualCoreマシンを使いメモリもたくさん積み、障害がないように心がけがけています。 出始めのころから効率化のためにエクストリームプログラミングも取り入れていました。 単体テスト、リファクタリングも当然行いますが、余計に開発速度が落ちています。 しかし開発速度は効率化とは無縁だとすら感じています。 仕事を減らすことが優先ではないか?と。 昔から創作活動は好

  • プログラマが仕様を決めればいい - GoTheDistance

    最近よく思います。 システム開発の上流工程においてはコードは出てこない。言葉や図解で埋めつくされて、最終的には日語でしかない。設計書とか仕様書とか。で、この大抵上流工程ではこれらのドキュメントに対するレビューなるものがあるのですが、これが実に無益なものだと感じることが多い。こんな所でPDCAまわして何が面白いんだろうとよく思う。 ここでチェックする多くのことは、言葉の解釈に関することがほとんどです。 この言葉はプロジェクトで使われていない 書き方が統一されていない 誤字脱字が多いので直せ。 この文章ではこのように解釈される恐れがある ここではこのような話になっていたがどうなのか こんなんばっか。どこもそうだと思う。解釈の違いは、要件の違い。なんちゃって。 で、結局こういうことを繰り返していくうちに段々とドキュメントがグダグダになっていく。そして繰り返していっても前提が変わってしまえば全部

    プログラマが仕様を決めればいい - GoTheDistance
  • その「プログラム設計書」が何を指してるのかわからないから土壇場で混乱する - @katzchang.contexts

    仕様書やプログラムを書く大変さ - GeekFactory http://d.hatena.ne.jp/oredoco/20080415/1208222548 プログラミングできない元請けがプログラム設計書をレビューするという矛盾 - yvsu pron. yas 上の方々の記事を読んで、その「プログラム設計書」って何なんだろうと思ったわけで…。 例えば、契約が「プログラム設計書一式によりプログラムを製造する」みたいなのだとしますよね。 でも、そのプログラム設計書はクラス図+シーケンス図みたいなものなのか、一つのまとまった処理…バッチ処理とかユーザイベントとかgetリクエストとかの入力に対するDBとか画面への出力を示したものなのか、内部変数とか内部ループのブレイク条件とかも示したものなのか、よくわからない*1。だから、受け取る段階になって混乱する。よくある話じゃないですか。 正直なところ、

    その「プログラム設計書」が何を指してるのかわからないから土壇場で混乱する - @katzchang.contexts
  • 1