人気ブログランキング | 話題のタグを見る

はこにわオーディオ工学研究分科会 (旧名: バスレフ研究所)

ソフトウェアのドキュメント

多自由度バスレフ研究所のサイトで配布している解析プログラムは、2015年からは更新されていませんが、いずれまた機能の追加を試みるかもしれません。
今のところは、グラフィックスはまだまだ4階料の余地があるものの、解析プログラム自体は結構うまくできているのではないかと思います。
配布しているバージョンごとに、ソフトウェアのドキュメントとプログラムのソースコードを含めてはいます。
配布ソフトに添付されているドキュメントは、ソフトウェアを使用するという目的で作成されており、通常のソフトウェアであればこれで十分なのですが、次回の機能追加のために、自分でわかるようにしておかなければならないと考えています。

随分前に、ドキュメントを書く、とこのブログに書きましたが、まだできていません。
少しずつ追加していますが、どのように書けば、後でも分かるのか試行錯誤するのに、頭を使います。
プログラムには、書いているうちに何だかわからなくなるのを防止するために、コメントを記入してあります。
自分のプログラムの場合には、コメントがかなりの分量を占めており、書いた自分ならある程度付いていけるので、これでもいいような気がしますが、やっぱり、これでは、よくわからないのだろうと思います。
以前には、フローチャートを作成するのを断念したこともあります。
職業プログラマではない自分には、指導者がいないので、自己流でやっています。
下を見ればきりがありませんが、上を目指してなんとかドキュメントを完成させたいと思っています。


by mcap-cr | 2017-12-05 23:59 | プログラミング | Trackback | Comments(2)
トラックバックURL : https://mcap.exblog.jp/tb/238046564
トラックバックする(会員専用) [ヘルプ]
※このブログはトラックバック承認制を適用しています。 ブログの持ち主が承認するまでトラックバックは表示されません。
Commented by hiro-osawa at 2017-12-06 04:12
昔他人の書いたプログラムのフロー構造資料、ドキュメントを作ってもらいたいとの依頼が来たことありました。
納入先から、まるで内容理解できないのでわかるようにしろとのクレームだったらしいです。作った本人は最後っ屁で転職してしまったので後の祭りです。もちろんそんな仕事うけられるはずがありません。また後から誰かにやらせれば済むと思ってるのは認識すらない証拠でした。こんなこと当時の民営化したばかりの電話会社がらみで、程度の低いことでした。
Commented by mcap-cr at 2017-12-06 06:39
> hiro-osawaさん
仕事でのプログラミングはやっつけ仕事になりがちなのかもしれません。
逆に大学の研究室とかでは、アルゴリズム部分は、明確にしていたりするのかもしれません。
プログラミングを一人に任せると、サポートできなくなるので、本来やってはいけなかったことなのかもしれません。
1人でのプロジェクトは、ソフトウェアにドキュメントを添付させて、検収時にチェックすればよいのでしょうね。

生演奏を主とすれば、オーディオは箱庭で充分でしょう。
by MCAP-CR
プロフィールを見る
画像一覧
更新通知を受け取る

最新の記事

スマホでPDFを見るって...
at 2022-06-29 06:21
趣味の違いは小異大異
at 2022-06-28 06:37
雑談
at 2022-06-27 06:15
何度も聴いて新しい発見
at 2022-06-25 16:34
自分の装置基準
at 2022-06-23 12:22
背中を見せる
at 2022-06-21 06:33
音源メディア
at 2022-06-21 06:30
ドミンゴは流石
at 2022-06-20 06:23
"サウンド変換"ソフトのバグか?
at 2022-06-19 10:43
パソコンのメンテナンス
at 2022-06-16 12:36
久しぶりにCDリッピング
at 2022-06-15 06:19
脳内補正
at 2022-06-14 06:23
まとめて聴くものではない
at 2022-06-13 06:21
パソコンの環境整備
at 2022-06-12 08:47
淡い期待が尽きる
at 2022-06-10 06:27
iPhone 壊れる
at 2022-06-08 06:40
オーディオ趣味の二極化
at 2022-06-08 06:39
小型コンピュータの修理(2)
at 2022-06-07 06:20
ケンプの録音を聴く
at 2022-06-06 06:18
小型パソコンの修理??
at 2022-06-05 16:01

以前の記事

2022年 06月
2022年 05月
2022年 04月
2022年 03月
2022年 02月
2022年 01月
2021年 12月
2021年 11月
2021年 10月
2021年 09月
2021年 08月
2021年 07月
2021年 06月
2021年 05月
2021年 04月
2021年 03月
2021年 02月
2021年 01月
2020年 12月
2020年 11月
2020年 10月
2020年 09月
2020年 08月
2020年 07月
2020年 06月
2020年 05月
2020年 04月
2020年 03月
2020年 02月
2020年 01月
2019年 12月
2019年 11月
2019年 10月
2019年 09月
2019年 08月
2019年 07月
2019年 06月
2019年 05月
2019年 04月
2019年 03月
2019年 02月
2019年 01月
2018年 12月
2018年 11月
2018年 10月
2018年 09月
2018年 08月
2018年 07月
2018年 06月
2018年 05月
2018年 04月
2018年 03月
2018年 02月
2018年 01月
2017年 12月
2017年 11月
2017年 10月
2017年 09月
2017年 08月
2017年 07月
2017年 06月
2017年 05月
2017年 04月
2017年 03月
2017年 02月
2017年 01月
2016年 12月
2016年 11月
2016年 10月
2016年 09月
2016年 08月
2016年 07月
2016年 05月
2016年 04月
2016年 03月
2016年 02月
2016年 01月
2015年 12月
2015年 11月
2015年 10月
2015年 09月
2015年 08月
2015年 07月
2015年 06月
2015年 05月
2015年 04月
2015年 03月
2015年 02月
2015年 01月
2014年 12月
2014年 11月
2014年 10月
2014年 09月
2014年 08月
2014年 07月
2014年 06月
2014年 05月
2014年 04月
2014年 03月
2014年 02月
2014年 01月
2013年 12月
2013年 11月
2013年 10月
2013年 09月
2013年 08月
2013年 07月
2013年 06月
2013年 05月
2013年 04月
2013年 03月
2013年 02月
2013年 01月
2012年 12月
2012年 11月
2012年 10月
2012年 09月
2012年 08月
2012年 07月
2012年 06月
2012年 05月
2012年 04月
2012年 03月
2012年 02月
2012年 01月
2011年 12月

最新のコメント

> muukuさん 確..
by mcap-cr at 12:23
状況も解らず、知識も経験..
by muuku at 08:37
> muukuさん ピ..
by mcap-cr at 16:09
ピアノロールはオンオフで..
by muuku at 13:54
> muukuさん 以..
by mcap-cr at 10:53
車田さんの電子ピアノの話..
by muuku at 09:56
> rokuさん ご紹..
by mcap-cr at 12:23
>ひょっとしたら、自分が..
by roku at 07:38
> tincanさん ..
by mcap-cr at 12:43
キビシィー、ポスターの写..
by tincan at 11:23

最新のトラックバック

島谷技研
from 島谷技研
musica
from musica
明日9/24(月祝)はス..
from 集まれ塩ビ管スピーカー主宰 ..
美しい美宮殿装飾と世界屈..
from dezire_photo &..
年末自作スピーカー系イベント
from 集まれ塩ビ管スピーカー主宰 ..
究極の愛を描いたワーグナ..
from dezire_photo &..
光と色彩を愛し生きる喜び..
from dezire_photo &..
新国立劇場バレエ団のソリ..
from dezire_photo &..
ダンテの『神曲』 ”地獄..
from dezire_photo &..
日本初公開のルノワール絵..
from dezire_photo &..

検索

ファン

ブログジャンル

画像一覧

イラスト:まるめな