大体は書けた様な気がする今は、Mirror-DTCのシェアウェア化を行うフェーズで、今週リリースする予定になっているのだが、最後の仕上げとして行っていた操作説明用のドキュメントも、今日の時点で大体は書けた様な気がしている。思う人もいるかもしれないのだが。その筋の人なら聞いた事がある筈なのだが、大昔から、コンピュータ関連の仕様書なんてモノには、どれだけ頑張っても、30%程度の仕様しか記述できない、という事になっている。int型だった場合、どういう振る舞いをするのか、だとかについては、その仕様書には記載されない訳だ。記述されないのか、というと、そんな話は上記の関数に限った話ではないし、どうなるのか、なんてのは常識だからでもあるのだが、実際の所としては、そんな事まで記述していると、仕様書が広辞苑みたいになってしまうから、でもある訳だ。いう事で、通常、ドキュメントには、全てが書かれる訳ではないので、そのドキュメントが読まれる時には、読み手の力量が問われる事になる訳だ。逆に言うと、読み手の力量が高い事を想定する場合には、ドキュメントには必要最低限の情報のみ載せれば良い事になるし、低い事を想定する場合には、常識的な話も含めて、必須でもない情報も、載せなければならなくなる訳だ。同じ操作説明書でも、書き方は一通りではない訳なので、書き上げてしまっても、これで良いのかなあ、と、思ったりもしてしまう訳だ。このため、作者的には、現状では、書けた様な「気がしている」訳なのだが、このブログを良く見ている人なら、作者が良く、「木を見て森を見ず」、という諺を使っているのを知っているかもしれない。作者がこの諺を良く使うのは、作者自身が、若い頃には、よく、こんな感じの愚行をやらかしたりしたからだ。目先の作業ばかり気にして、その目的を意識していないと、いくら頑張って作業しても、事態は好転しないばかりか悪化したりもする訳だ。いう事にならない様に、作業というのは、まず、その必要性を鑑みて過不足なく行える様に計画を立ててから行うのが望ましい訳なのだが、森というのは木の集合体だったりもする訳だ。木が無いと森も見えてこない場合もある訳だ。いう事で、個別の操作説明書なんてモノは、上記の木にしかならないのだが、それらが合わされば、森になってくれるかもしれない。実際には、操作説明書だけでは全然足りないので、既に、このブログに色々と書いてきたリもしているし、リリース時に書く事になる筈のリリース記事にも、もう少し大きな話は書く事になる筈だ。今回書いた操作説明書というのは、それらと一緒に、森を形成する事になる筈なのだが、実際の所、README.txtすら読まない人には、そんな事は無関係な訳だ。?自称初心者の誤った謙遜は伸びの鈍化を招き相手に迷惑をかける上記は、今日、Googleで、「自称初心者」を検索すると出てきたページの幾つかになるのだが、上記を読めば判る様に、少なくともIT業界では、自称初心者は軽蔑されていて、自分は初心者だと言うだけで、相手を怒らせ、マトモに対応してもらえなくなる場合も多い訳だ。少なくとも、上記の記事を書いている様な人達は、そんな感じなので、私は初心者なんだからもっと丁寧に教えろ、なんて事を言った日には、激怒される可能性もあるかもしれない。Mirror-DTCというソフトは、その基本機能からして、初心者お断りな所もある訳なので、作者の所にも、間違っても、上記の様なメールは送らない様にした方が良いかもしれない。Adsense)サービスを利用しています。使用して、ユーザーのウェブサイトでの閲覧履歴に基づく広告を配信します。パートナーは当サイトや他のサイトへのアクセス情報に基づく広告をユーザーに表示できます。収集された情報がGoogleによってどの様に使用されるか、収集される情報をユーザーが管理する方法については、以下のリンクを参照下さい。