« 料理を作る時の思い | トップページ | 事前準備はしっかりと »

2013年11月14日 (木)裏メニュー

おはようございます。本日の当番、プログラマのY.Hです。

先日、知人とお寿司屋さんに行きました。
いつも行っているところではなく、
たまには違う店にしようということで別の店に行くことに。

いざ注文しようとメニューを見ると…
なんと、僕のお気に入りのだし巻き卵が
メニューにないではないですか

少しの間、絶望しましたが、
お店の人に聞いてみるとメニューに書かれていないだけで
ありますよ~とのこと。
とりあえず一安心でしたw


さて、プログラムにおいて
飲食店のメニューにあたるのはドキュメントだと思うのですが、
プログラム処理は実装されているけど、
ドキュメントに書かれていないといったケースが良くあります。

他人が作ったプログラムを触る際、
一緒にドキュメントを渡されることもあるのですが、
ソースコードの内容と一致してないこともしばしば。

書かれていないクラスや関数があったり、
その逆もまた然り…。

ドキュメントを更新すれば良いのですが、
忙しくてなかなか難しい人も多いのではないでしょうか。

まぁ、ソースコードからドキュメントを自動生成する方法もあるので、
そちらを使うというのもありですが。


…というわけで、ドキュメントを見て分からないことがあれば
ソースコードを見るようにしています。

ソースコードを見ていけばドキュメントに頼らずとも
実装されている内容がわかりますよね。
まぁ読み解くのに時間はかかるかもしれませんが(汗

ただし、ソースコードが公開されていないライブラリについては
どうしてもドキュメント頼りになってしまいますので、
そのあたりは注意が必要ですね。


今度またそのお店に行ったら、
他の裏メニューを探してみようかなw

follow us in feedly
result = encodeURIComponent( "http://www.accessgames-blog.com/blog/2013/11/post-4d21.html" );document.write( "result = " , result );&media=https%3A%2F%2Ffarm8.staticflickr.com%2F7027%2F6851755809_df5b2051c9_z.jpg&description=Next%20stop%3A%20Pinterest">

| | コメント (0) | トラックバック (0)

« 料理を作る時の思い | トップページ | 事前準備はしっかりと »

プログラマー」カテゴリの記事

コメント

コメントを書く



(ウェブ上には掲載しません)


コメントは記事投稿者が公開するまで表示されません。



トラックバック


この記事へのトラックバック一覧です: 裏メニュー:

« 料理を作る時の思い | トップページ | 事前準備はしっかりと »