ダメなマニュアルの特徴 - まめめも

暮らしカテゴリーの変更を依頼記事元:

mametter.hatenablog.com

48users がブックマークコメント

コメント

13

記事へのコメント13件

注目コメント
新着コメント

注目コメント算出アルゴリズムの一部にLINEヤフー株式会社の「建設的コメント順位付けモデルAPI」を使用しています

規約違反を報告

アプリのスクリーンショット

いまの話題をアプリでチェック！

バナー広告なし
ミュート機能あり
ダークモード搭載

アプリをダウンロード

関連記事

{{ total_bookmarks_with_user_postfix }}{{ root_title }}

ダメなマニュアルの特徴 - まめめも

めちゃくちゃ遅い反応ですが、「よく言ってくれた！」という話。現状のRDocはユーザリファレンスに向い... めちゃくちゃ遅い反応ですが、「よく言ってくれた！」という話。現状のRDocはユーザリファレンスに向いてないと思ってる。 RDoc書いただけで「リファレンスは完璧だお！」とか言ってるやつなんなの - Greenbear Diary (2009-06-04) 以下関係あるようなないような話。わが身は振り返らない方向で。ダメなマニュアルの特徴 rdoc に限った話ではないですが、以下はダメなマニュアルに共通する特徴だと思います。クラスやメソッドを ABC 順に並べているメソッドの説明が長いサンプルコードがないこういう文書は読み手を普通のプログラマだと思ってません。なぜダメか ABC 順だと、どこから読めばいいかわからない。砂漠の真ん中で迷子になったような気分になります。早く使ってみたいのに使えない歯がゆさ。説明が長いのは、メソッドの名前が適切でない可能性や、無駄に全機能を列挙しよ

ブックマークしたユーザー

techtech05212023/10/09
ohnishiakira2012/03/01
aereal2010/05/21
joan92009/10/07
kokorokara2009/06/30
masakielastic22009/06/29
Gesaku_G2009/06/29
omine32009/06/28
bojovs2009/06/28
tsutomura2009/06/27
IwamotoTakashi2009/06/27
pekepekesamurai2009/06/27
hyoromo2009/06/27
yoshi_6_172009/06/26
hidehish2009/06/26
k1LoW2009/06/26
frontline2009/06/26
takuto_h2009/06/26

同じサイトの新着

同じサイトの新着をもっと読む

いま人気の記事

いま人気の記事をもっと読む

いま人気の記事 - 暮らし

いま人気の記事 - 暮らしをもっと読む

新着記事 - 暮らし

新着記事 - 暮らしをもっと読む

いま人気の記事 - 企業メディア

企業メディアをもっと読む

設定を変更しましたx