[仕様書][設計書] 設計書の効果とは

こんにちは

今日もソフトウェアについてほのぼのと記載します。

現在、他社が書いていてエンドユーザが指摘していたソースを、私が所属している

会社がメンテナンスしている状況です。

1つのcソースファイルで、通信、フラッシュアクセス、ユーザインタフェースとして公開しているやらで、

3000行近いソースとなっていました。。。

それに対して今行っているのは

・ファイルを機能毎に分ける

・レイヤに分けてそれぞれの役割を割り振る

です。

現在、変更仕様書なるものを書いています

が、恥ずかしながら

在職中、書いたことがなかったです。

大手と中小の違いはこういうところなのでしょうか。

また、イメージをソースに書く前に

設計書としてエクセルシートにフローチャートを

書いていくのは必須のようで、

設計書レビューの時に認識を合わせやすくするのによいそうです。

納期があるのに時間がかかってしまうのは仕方ないのかしら。

どうすれば早く書けるのでしょう。

[仕様書] ヘッダファイルの使い方

こんにちは

今日もソフトウェアについてほのぼのと記載します。

現在、他社が書いていてエンドユーザが指摘していたソースを、私が所属している

会社がメンテナンスしている状況です。

指摘事項のうち、ヘッダファイルの扱いが参考になりました。

・ヘッダファイルはユーザに公開している仕様書のようなものです。

ということです。

お客さんはこのヘッダファイルだけ見てくださいね。

といった使い方を想定しているそうで、

内部処理は、ユーザーに意識させない造りにする必要があるとのことです。

仕様書にも、お客さんはこの章だけみてくださいね。

ということのようです。

基本的といえば基本的ですが、為になります。