inabajunmr inabajunmr 2015-05-28 21:22:40

[Java] わかりやすいコメント このエントリーをはてなブックマークに追加

投稿者からのアピールポイント

とてもわかりやすい

//インスタンスを作る
List<String> list = new ArrayList<String>();

使い方ヒント: 「これは臭う」という行を見付けたら、各行のsmellをクリックしてマーキングしておきましょう(要Twitter OAuth認証)

コメント(2)

#1 InternalServerE InternalServerE 2017-04-09 05:03:36  

  • 複数行にわたる処理の流れをわりと丁寧にコメントしたい場合(複雑な処理を書くケースや、設計書と実装の対応が追いづらいような処理を書くケースが主に該当)
  • 視覚的に見落とさないようなメッセージングを行いたい場合(インスタンス生成であれば、オブジェクトの生成・消滅のライフサイクルを明示したい場合ですね)

こういうケースだと、単純な内容でもあえてコメントに残すことは普通にあったりします。
「アピールポイント」のコードだけ単独で見て、ウンコかどうかって判断できますかねえ。

#2 deigotter deigotter 2017-06-10 20:30:49  

普通は「@@@を格納するリスト」とか書くんだよ だからウンコ

コメント投稿には、twitter認証が必要です。

Twitter認証

このウンコードに臭った人は、こちらのウンコードにも臭ってます

[Java] 連番

このエントリーをはてなブックマークに追加

もはや人間が読むものではない。

...

package com.renban.erq053.czp008;

/**...

鑑賞する »

[Java] is禁止令

このエントリーをはてなブックマークに追加

ウンコードの趣旨とは違い、レビューで指摘...

// Mod yamada Start

// 一般的に考えて真偽値を返すメ...

鑑賞する »

[Java] もうコメント書くなお前

このエントリーをはてなブックマークに追加

改修案件でぶち当たったソース マジでこ...

/**
  *
  *   〇〇の値を取得する
  *
  */
pu...

鑑賞する »