アカウント名:
パスワード:
リファレンスはある程度知っていれば何が書いてあるかわかるけど、所見では何の事やらさっぱりなことが多い。概念的な説明が不足していると感じる。
Androidのだとクラスのメンバ一覧の説明があってもそのクラスがどういう役割で他のクラスとどう関わるかみたいなところが見えてこない。
#オンラインは遅いからリファレンスはローカルで見てるだけだったりして
そのＡＰＩを通して向こう側が何をするのか、を知った上でこちらのアプローチを考える、べきだと思うので「お前はなにをするの？」が知りたいと思うのだけど、「呼び出し方はこうよ」の情報で終わっていることが多いと思う。＞MSDN ライブラリそういう読み物を書くのが大変だという気持ちはわかるし、そのような読み手は想定していないのかもしれないが。
APIの説明なんて、そういう書き方しかできないでしょ。サンプルとの役割分担で問題ない。
ネジの説明に用途を色々と書くようなもんで、基本的には仕様のみで良い。
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
日々是ハック也 -- あるハードコアバイナリアン
説明はあるけれど… (スコア:0)
リファレンスはある程度知っていれば何が書いてあるかわかるけど、
所見では何の事やらさっぱりなことが多い。
概念的な説明が不足していると感じる。
Androidのだとクラスのメンバ一覧の説明があってもそのクラスがどういう役割で
他のクラスとどう関わるかみたいなところが見えてこない。
#オンラインは遅いからリファレンスはローカルで見てるだけだったりして
Re: (スコア:1)
そのＡＰＩを通して向こう側が何をするのか、を知った上でこちらの
アプローチを考える、べきだと思うので「お前はなにをするの？」が
知りたいと思うのだけど、「呼び出し方はこうよ」の情報で終わって
いることが多いと思う。＞MSDN ライブラリ
そういう読み物を書くのが大変だという気持ちはわかるし、そのような
読み手は想定していないのかもしれないが。
Re: (スコア:0)
だから、まずサンプルなりを見て、なるほどこういう流れで処理するんだ！というのを把握した上で読むと理解できるけど、いきなりAPIだと、でどうすればいいの？って感じになる。自分の場合。
Re:説明はあるけれど… (スコア:0)
APIの説明なんて、そういう書き方しかできないでしょ。
サンプルとの役割分担で問題ない。
ネジの説明に用途を色々と書くようなもんで、基本的には仕様のみで良い。