自分用のアプリ開発の仕様書ってどうしてます？

質問

PHPとMySQLを使ってサイトを運営したり、Excel VBAで私生活を便利にするツールを作ったりしています。
人に提供するものではなく、あくまで自分で使うようで、自分一人で開発しています。

ただ、本職のプログラマーでもなければサンデープログラマーですらなく、必要になったら調べて作るという程度です。

なので、本来プロが作る時みたいに全体を決め作るということができず、作りながらこういう機能が必要だったと思いつき追加するという作り方になっています。

そのせいかソースはグチャグチャで、はっきり言って自分で書いたソースを見直すのが嫌になるほど。
何か機能を追加したくて数カ月後に嫌々見直すときには何のソースだったかすら忘れていたりして苦労しています。

なので自分用のアプリとかでも仕様書が必要なのかなと。

ただ、先程も書きましたが、なんちゃってプログラマーなので、会社にある仕様書なんかを見ても何を言ってるのかわけわからん状態で、そもそも作りながら出ないと思いつけないので、作る前から仕様を決めてということが難しいです。

かといって作るときに仕様書を書くというのも面倒くさいし、作りながらだと仕様書もグチャグチャになりそうだし。

本職の人は、自宅で自分用のアプリやツールなんかを作る場合も仕様書は作るんでしょうか？
それとも本職ともなればソースも綺麗に書けるから自分用のものなら仕様書は不要？

仕様書を作ってる方は、どんなふうに作ってるか教えていただけないでしょうか？

人と共有するものではないので仕事で使うようなガチなものでなくても良いのはわかるんですが、それですらいまいちイメージが付かないです。

OSはWindows10、Office365は使ってるのでWordやExcelは使えます。
他に仕様書を作るのに便利なソフトとか、こういう使い方してるとかあれば教えていただけないでしょうか？

回答No.3

bya00417 · ベストアンサー

ソースコード内にコメントを残す癖をつけたらいいと思います。
PHPDoc形式でコメントを書いておけばIDEが勝手に読み取ってプログラミング中に情報を表示してくれてアシストしてくれたり、ドキュメント生成ツールで簡易仕様書が作れたりして便利です。
PHPDoc形式はPHP以外でも利用されているので、覚えておくといいと思います。

お礼

IDEは扱いが難しくて何が良いのか全く分かりませんでしたが、そういうことができるんですね。
これを機にIDEの勉強もしてみたいと思います。
ありがとうございます。

回答No.2

noname#263248

自分用とか社内用でも、ある程度の仕様書があった方が楽ですので、ソースコードの最初にコメントで書いたりしてます
これも思い付きで機能一覧を書く程度です
自分で使うツールなら30行もないくらいですが、こういうのを書いておかないとなかなか進まない、やる気が出ないのです

回答No.1

chie65536（@chie65535）

＞本職の人は、自宅で自分用のアプリやツールなんかを作る場合も仕様書は作るんでしょうか？

作りません。

＞それとも本職ともなればソースも綺麗に書けるから自分用のものなら仕様書は不要？

いえ、本職でも「ソースはグチャグチャ」ですよ。仕様書も「営業とクライアントを納得させるだけのウワベだけの物」なので「仕様書と実際の実装が異なる」なんてのはザラです。「見た目と表面上の動作さえ仕様書通りならそれで良い」が実情です。

また、大きなプロジェクトだと、部分ごとに複数人で書くので「整合性を取るため」に、どんどん複雑怪奇になっていきます。

なので「退職者が出て引き継ぎ」とか「前任者が逃げて引き継ぎ」とかがあると、軽く死ねます。