プログラミング作法

目次

1. このページは
2. tips
   1. メソドロジー
   2. 16進数記法で意味のある言葉
   3. 命名規則
3. プログラミング指針
4. プログラミング手順
5. プログラミング心構え
6. 開発プロセス
   1. ユーザビリティテスト
   2. セルフ・マネジメント
   3. ビルド・リリース
   4. デスマーチ
7. 用語
8. 参考文献・参考ウェブページ
9. 履歴

このページは

プログラミング作法についてのメモ、TIPS。

tips

メソドロジー

16進数記法で意味のある言葉

16進数でかける単語。
これらを利用するとデバッグ時に初期化した数から変化しているかどうか確認する事に使える。

1. 0xbad
2. 0xbabe
3. 0xcafe
4. 0xdead
5. 0xbeef
6. 0xface
7. 0xfeed
8. 0xdeadbeef
9. 0xabadcafe
10. 0xabadface
11. 0xbabeface

命名規則

ハンガリアン記法

• ハンガリアン規約による名前は3つの部分から構成される。

  変数名 = 一つ以上のプリフィックス + ベース型 + 限定子

• MS 発端。
  
• 利点
  
  • 多くの名前が標準的に決められているため、個別のプログラムや関数で覚えるべき名前が少なくて済む。
  • 個々人の命名による不正確になりがちな部分を正確に表現できる。

• 日本語での解説（個人ページ）
• MS 解説(英語)　

the Indian Hill C Style and Coding Standards

広い範囲のコーディングスタイルの規約。
シンプルでわかりやすい、常識的なスタイルになるので必須。

• 仕様書(日本語)

短縮形

プログラミング指針

主な方法

1. フローチャート
2. トップダウンプログラミング
3. ボトムアッププログラミング
4. 構造化プログラミング
5. オブジェクト指向設計

プログラミング手順

ソフトウェアのライフサイクル

1. 要求仕様書作成
2. 機能仕様書作成
3. コード設計
   • 主要アルゴリズム
   • モジュール仕様
   • ファイルフォーマット
   • データ構造
4. コーディング
   1. プロトタイプ作成
   2. 不足部分の付加
5. テスト
6. デバッグ
7. リリース
8. 保守
   バグ修正
9. 改定とアップデート
   はじめから繰り返す

プログミング心構え

プログラミングする時に時たま何も出来ないときがある。
そういったときでも何とかエディタを立ち上げて編集し出せば何とかなることがある。
それをはじめることが難しい。
http://japanese.joelonsoftware.com/Articles/FireAndMotion.html

開発プロセス

ユーザビリティテスト

定量的評価手法としては、アンケート調査。
定性的評価手法としては、ヒューリスティック（経験則）評価、ユーザビリティテスト（被験者が実行する過程を観察し、行動、発話からUIの問題点を発見する）。

参考： http://www.usability.gr.jp/whatis/evaluation_method.html

セルフ・マネジメント

自分ひとりでできるプロジェクトの改善の方法。
1. デイリービルドできるサーバをつくり、makefile を書く。cronも作る。ユーザビリティテストを自分で行う。
2. CVS とBTS をつくり、自分で運営する。
3. 自分で自分のスケジュールと仕様書を書く。うぬぼれた指摘のメールは送らない。事実のみ。
4. ネックの人物がいれば、バグを見つけたときに修正せずにバグの結果のみを報告する。 自身で気が付けば成長できる。成長したら一緒にできる。
5. 生産性を確保するためならカフェや会議室で仕事しても良い。絶対にメーラやチャットは常駐させてインタラプトの隙を自ら作ってはいけない。
6. これらのプロセスにこだわりすぎず、結果を出しつつ実行すること。

ビルド・リリース

ビルドは定期的にリリースすることで安定性を図ることが可能。 （不具合数・修正数・修正失敗数・未修正不具合数などをカウント）
また、QAチームをプロジェクトで設置することも重要。
ビルドをリリースするタイミングは多いと時間のロスになるが、 フィードバックにつながる。 この期間はトレードオフになるが一週間か隔週が一般的。

用語 ---- showstopper, blocker, showstopper bug : 致命的な不具合でリリースを妨げるバグ。

デスマーチ

デスマーチに関する事柄のメモ。

• クライアントは自分の望むことを知らない。
  例えばかっこいい家がほしい、といったときにそれが 家具のメーカーであったり、表札であったり、詳細を自分が知らないことと、 一緒の原理で専門でなければ詳細を把握していないこと、を知る必要がある。
  同様にボキャブラリも異なることを知る必要がある。
  それが理解を助けるし、調査を入念に行う原動力になる。
  http://japanese.joelonsoftware.com/Articles/TheIcebergSecretRevealed.html
• クライアントの何かのソフトウェアに対する評価はスクリーンショットの部分が大きい。
  例えばlinux の新しいディストリビューションの評価はデスクトップの背景 だったりする場合がある。
  また、プログラムの進捗も内容にかかわらず見た目が影響するときがある。
  昨日は目に見えないもの。
  

用語

参考文献・参考ウェブページ

1. Coding Style 個人リスト。重宝
2. JoelOnSoftware 著名なプログラマJoel 氏の興味深い考察集 日本語訳
   時間の空いたときにちょくちょく読みたい。
   
3. C 実践プログラミング
4. プログラミング作法

履歴

• 2004/00/00 初版作成
• 2006/03/11 修正
• 2006/03/25 修正 Joel on software