- ベストアンサー
自分用アプリ開発における仕様書作成の必要性
- 自分用のアプリを開発する際、仕様書の作成について悩んでいます。PHPとMySQLを使ったサイト運営やExcel VBAを駆使してツールを作成しており、必要な機能を作りながら追加する形で開発しています。そのため、ソースコードが散らかり、自分で見直すのが困難になっています。
- 仕様書の必要性を感じるものの、プロのように事前に仕様を決めてから開発することは難しいと感じています。作りながら仕様書を作ると、それもまたグチャグチャになりそうで困っています。本職プログラマーは自宅開発の場合も仕様書を作成しているのでしょうか?
- Windows10やOffice365のWordやExcelを使用していますが、他に仕様書作成に便利なソフトがあれば知りたいです。仕様書を作成する方々の方法やツールについてアドバイスをいただきたいです。
- みんなの回答 (3)
- 専門家の回答
質問者が選んだベストアンサー
ソースコード内にコメントを残す癖をつけたらいいと思います。 PHPDoc形式でコメントを書いておけばIDEが勝手に読み取ってプログラミング中に情報を表示してくれてアシストしてくれたり、ドキュメント生成ツールで簡易仕様書が作れたりして便利です。 PHPDoc形式はPHP以外でも利用されているので、覚えておくといいと思います。
その他の回答 (2)
自分用とか社内用でも、ある程度の仕様書があった方が楽ですので、ソースコードの最初にコメントで書いたりしてます これも思い付きで機能一覧を書く程度です 自分で使うツールなら30行もないくらいですが、こういうのを書いておかないとなかなか進まない、やる気が出ないのです
- chie65535
- ベストアンサー率44% (9295/20928)
>本職の人は、自宅で自分用のアプリやツールなんかを作る場合も仕様書は作るんでしょうか? 作りません。 >それとも本職ともなればソースも綺麗に書けるから自分用のものなら仕様書は不要? いえ、本職でも「ソースはグチャグチャ」ですよ。仕様書も「営業とクライアントを納得させるだけのウワベだけの物」なので「仕様書と実際の実装が異なる」なんてのはザラです。「見た目と表面上の動作さえ仕様書通りならそれで良い」が実情です。 また、大きなプロジェクトだと、部分ごとに複数人で書くので「整合性を取るため」に、どんどん複雑怪奇になっていきます。 なので「退職者が出て引き継ぎ」とか「前任者が逃げて引き継ぎ」とかがあると、軽く死ねます。
関連するQ&A
注目のQ&A
コミュニティ
クモ
タランチュラは美味しいらしい。ジョロウグモ取ろうと思えば取れるけど、クモは好きなので、生きてるのは取りたくない。12月になって昨日まで生きてたのが屋根に落ちてたので、焼いて食べたら美味しかった。山菜に混じってた緑色のクモを一緒に味噌汁にして食べたらプチッとした触感だった。
体験記13 紛らわしい副作用
どピンクの抗がん剤は見た目本当にピンクの色水で、どうにかならなかったのかと思いますが、ならなかったんでしょうねw出る方も、目の覚めるようなピンクでした。私の場合は、2回もトイレに行けば色は出なくなり、血尿も出ることなく終わりました。因みに、私の治療に使われた薬はピンクですが、抗がん剤の種類によっては尿が真っ青になる薬もあるそうです。赤かったり青かったり、強い薬の影響は大変ですな。
赤ちゃんが生まれたら、家事の分担はどうする?
11月22日(日)は「いい夫婦の日」ですね😊赤ちゃんが生まれると、授乳やおむつ替えなどのお世話が増えて毎日の暮らしも大きく変わりますが、つい赤ちゃんのお世話が優先になり、これまでのように家事の時間がとれなくなることも...💦そんなママパパたちの悩みを助産師さんに聞いてみたところ、夫婦の「家事の役割 見直しリスト」を教えてくれました!夫婦で家事の分担を見直してみると、お互いの意外な得意・不得意に気づくこともあるようです。〜産後の暮らしに備えて、家事の分担を考えてみませんか?〜▼助産師監修の記事はこちら産後の不安はパパ家事で解決!みなさんのご家庭では、家事をどのように分担していますか?先輩ママ・パパのみなさん、「これは分担してよかった!」「産前に話しておけばよかった!」ということがあれば、ぜひ教えてください✨
筋トレあるある
筋トレあるある
本屋さんに行ってみたくなる本 — 『本屋さんのある街で』
凪良ゆうさんを追いかける流れで手に取りました。ただ、凪良さんの一編は『多類婚姻譚』ですでに読んでいた作品。それでも、読んでよかったです。五人の作家が描く、本屋さんを通じた人の物語。どの作品も読みやすく、こんな、本を買うことだけでは終わらない出会いがある本屋があるといいなあ、こんな体験をしたいなあ、と純粋に楽しみました。特に心に残ったのは、瀬尾まいこさんの「続きは書店で」と、一穂ミチさんの「歌うように生きて」です。登場人物が絞られているからこそ、一人ひとりの姿や気持ちがくっきりと見えてくる。「歌うように生きて」は、恋愛のはかなさが心にしみました。凪良さんを目当てに開いた本でしたが、読み終えたときには、瀬尾さんと一穂さんのほかの作品も読んでみたくなっていました。本屋さんが知らなかった本へつないでくれるように、この一冊も、私を次の作家へつないでくれました。本好きの方に、ぜひ手に取ってほしいです。https://amzn.asia/d/0gcRUoFY






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