https://b.hatena.ne.jp/entry/s/qiita.com/tonluqclml/items/bc63c294dda6010b63e9 私はウンザリしています。 「○○対応」は曖昧なのでやめてください。「○○が■■になるバグを修正した」の方が直接的です。 こんな指摘を、新人が入ってくるたびにコードレビューやドキュメントレビューで繰り返して... https://b.hatena.ne.jp/John_Kawanishi/20250926#bookmark-4672049263013901058 ｢新人はなぜみんな同じような分かりにくい表現をつかってきます｣｢工学部では、こんな言葉遣いをするよう指導してるんでしょうか？｣卒検だか卒論かいて卒業してきて入ったはずなのになんなんだろう自分も(焦 2025-09-26T04:04:03Z 文章術 https://b.hatena.ne.jp/m41bulldog/20230828#bookmark-4672049263013901058 2023-08-28T10:27:47Z https://b.hatena.ne.jp/techtech0521/20230520#bookmark-4672049263013901058 2023-05-20T04:47:26Z あとで読む https://b.hatena.ne.jp/mtzml/20210322#bookmark-4672049263013901058 2021-03-21T18:02:46Z https://b.hatena.ne.jp/susue/20210105#bookmark-4672049263013901058 2021-01-04T16:07:35Z 仕事 https://b.hatena.ne.jp/mikage014/20201220#bookmark-4672049263013901058 2020-12-20T04:35:14Z コードレビュー https://b.hatena.ne.jp/tettekete37564/20191105#bookmark-4672049263013901058 4,5 以外はホンット大事。4 は書き忘れてるパターンが多いの書いてあるだけ御の字。5 は TPO による。5W1H とまでは言わないものの、一文はひと組の主語述語で定義的に書いてくれ。定義とは範囲を明確な粒度に限定すること 2019-11-05T11:34:58Z https://b.hatena.ne.jp/arukanaru/20190902#bookmark-4672049263013901058 2019-09-01T18:26:09Z あとで読む https://b.hatena.ne.jp/teracy_junk/20190820#bookmark-4672049263013901058 2019-08-20T06:25:38Z 日本語 チーム開発 https://b.hatena.ne.jp/rabbit2go/20190802#bookmark-4672049263013901058 2019-08-01T21:42:46Z 日本語 レビュー https://b.hatena.ne.jp/takehikom/20190802#bookmark-4672049263013901058 2019-08-01T21:17:49Z https://b.hatena.ne.jp/manabou/20190801#bookmark-4672049263013901058 2019-08-01T04:10:18Z review communication codereview comment book https://b.hatena.ne.jp/Magicant/20190731#bookmark-4672049263013901058 レベルの違ふ人と仕事をするのは大変ですねー 2019-07-31T13:14:11Z 日本語 https://b.hatena.ne.jp/kamenashi1982/20190731#bookmark-4672049263013901058 “これらの定型句は情報を増しません。口語での「ええっと」「その〜」などと同じ、心のうめきに過ぎないからです。” ワカル〜 2019-07-31T05:38:36Z https://b.hatena.ne.jp/starneon3517/20190731#bookmark-4672049263013901058 2019-07-31T03:51:55Z 日本語 あとで読む qiita https://b.hatena.ne.jp/treeapps/20190731#bookmark-4672049263013901058 人間にこれらを指摘されると嫌な気分になって反発されそうなのと、その人独自の言葉遣いを強要するだけで終わりそうなので、どうしてもやるならRedPen等で機械的に緩めにチェックする仕組みとかを作った方がよさそう 2019-07-31T02:16:10Z https://b.hatena.ne.jp/mjtai/20190731#bookmark-4672049263013901058 2019-07-31T02:08:07Z 仕事 https://b.hatena.ne.jp/atyks/20190731#bookmark-4672049263013901058 2019-07-31T01:54:38Z https://b.hatena.ne.jp/gen0083/20190731#bookmark-4672314649831195298 思わずやっちゃってることあるなあ。 書いてあることはごもっともだと思う。レビューに限らない話。 2019-07-31T01:20:27Z https://b.hatena.ne.jp/sgwr1129/20190731#bookmark-4672049263013901058 2019-07-31T00:50:09Z コメント https://b.hatena.ne.jp/northlight/20190731#bookmark-4672049263013901058 この程度の日本語運用能力もない自称エンジニアのあまりに多いことよ。 2019-07-31T00:40:58Z https://b.hatena.ne.jp/nagabow/20190731#bookmark-4672049263013901058 日本語が不自由な人が多いからなぁ 2019-07-31T00:02:48Z https://b.hatena.ne.jp/mfham/20190731#bookmark-4672049263013901058 2019-07-30T22:42:38Z 日本語 https://b.hatena.ne.jp/k_hamada_1988/20190730#bookmark-4672049263013901058 2019-07-30T13:22:49Z Develop https://b.hatena.ne.jp/ousou_san/20190729#bookmark-4672049263013901058 2019-07-29T09:35:44Z あとで読む https://b.hatena.ne.jp/goto_haru/20190729#bookmark-4672049263013901058 2019-07-29T01:23:50Z あとで読む https://b.hatena.ne.jp/vanbraam/20190728#bookmark-4672049263013901058 一番欠けてるのは「想定読者」の情報.想定読者が決まれば,この文書の指摘の半分くらいは無意味になる気がする 2019-07-28T13:43:02Z 疑義あり 言語 communication https://b.hatena.ne.jp/winterfall/20190728#bookmark-4672049263013901058 2019-07-28T03:53:28Z https://b.hatena.ne.jp/lugecy/20190728#bookmark-4672049263013901058 2019-07-28T01:26:56Z article programming development stars onemore-read https://b.hatena.ne.jp/garlicgun/20190727#bookmark-4672049263013901058 2019-07-27T00:54:46Z プログラミング https://b.hatena.ne.jp/kzk_flora/20190727#bookmark-4672049263013901058 2019-07-27T00:21:40Z https://b.hatena.ne.jp/kts56/20190727#bookmark-4672049263013901058 「〜するべきである」と「〜しなければならない」って同じ意味じゃないの？ 2019-07-26T23:26:21Z https://b.hatena.ne.jp/manimoto/20190727#bookmark-4672049263013901058 2019-07-26T20:52:13Z あとで読む https://b.hatena.ne.jp/yancy1969/20190727#bookmark-4672049263013901058 2019-07-26T18:10:46Z https://b.hatena.ne.jp/scheat/20190727#bookmark-4672049263013901058 2019-07-26T17:09:27Z あとで読む https://b.hatena.ne.jp/yatta47/20190727#bookmark-4672049263013901058 2019-07-26T16:38:44Z https://b.hatena.ne.jp/hiro_curry/20190727#bookmark-4672049263013901058 これが仕様書だったら気になるかな。プログラムはプログラミング言語だけで作るわけではないので。 2019-07-26T16:21:32Z https://b.hatena.ne.jp/Watson/20190727#bookmark-4672049263013901058 2019-07-26T16:18:17Z review https://b.hatena.ne.jp/lbtmplz/20190727#bookmark-4672049263013901058 いきなり言葉遣い指摘してくる奴か、大抵のこれらは本題の後に追加で指摘すべき 2019-07-26T16:12:09Z https://b.hatena.ne.jp/crexist/20190727#bookmark-4672049263013901058 コメントが大事なのはわかるが指摘がくっっっっぅっそしょーもない。 別にコード自体を客に見せる訳じゃ無いならこの神経質さは無意味。芸術品作ってるんじゃ無いんだぞ 2019-07-26T15:21:23Z あとで消す https://b.hatena.ne.jp/kmttr/20190727#bookmark-4672049263013901058 2019-07-26T15:11:59Z https://b.hatena.ne.jp/marutaku0131/20190727#bookmark-4672049263013901058 2019-07-26T15:11:18Z https://b.hatena.ne.jp/noken3/20190726#bookmark-4672049263013901058 2019-07-26T14:59:46Z あとで読む https://b.hatena.ne.jp/diveintounlimit/20190726#bookmark-4672049263013901058 正しい手斧の磨き方（皮肉 2019-07-26T14:03:16Z https://b.hatena.ne.jp/NOKIA/20190726#bookmark-4672049263013901058 2019-07-26T14:02:37Z https://b.hatena.ne.jp/eronis/20190726#bookmark-4672049263013901058 2019-07-26T13:56:03Z https://b.hatena.ne.jp/Ioannes/20190726#bookmark-4672049263013901058 2019-07-26T13:43:27Z https://b.hatena.ne.jp/ginga0118/20190726#bookmark-4672049263013901058 2019-07-26T13:42:40Z あとで読む https://b.hatena.ne.jp/s_ryuuki/20190726#bookmark-4672049263013901058 2019-07-26T13:41:35Z プログラム https://b.hatena.ne.jp/latemder/20190726#bookmark-4672049263013901058 2019-07-26T13:17:46Z あとで読む https://b.hatena.ne.jp/syoukei81/20190726#bookmark-4672049263013901058 2019-07-26T13:06:37Z プログラミング https://b.hatena.ne.jp/ytsmy/20190726#bookmark-4672049263013901058 2019-07-26T13:05:28Z あとで読む https://b.hatena.ne.jp/tamanishi/20190726#bookmark-4672049263013901058 2019-07-26T13:03:11Z https://b.hatena.ne.jp/lnimroder/20190726#bookmark-4672049263013901058 知見が得られた がわからんってどういうことだ。国語の成績2ぐらいだったのか？ 2019-07-26T12:52:50Z https://b.hatena.ne.jp/neku009/20190726#bookmark-4672049263013901058 2019-07-26T12:41:34Z https://b.hatena.ne.jp/nyoron0128/20190726#bookmark-4672049263013901058 批判が多いけど個人的には割と同意。コードレビューに限らず、限られた文字数内で必要な情報を詰め込んで伝達齟齬が発生しないように文章を作るのは、意識していないとなかなかできない。 2019-07-26T12:22:05Z https://b.hatena.ne.jp/nukosan555/20190726#bookmark-4672049263013901058 2019-07-26T12:09:50Z あとで読む https://b.hatena.ne.jp/kiyo_hiko/20190726#bookmark-4672049263013901058 わかる。でもコメントにそこまでコスト掛けるより帰る。せいぜい意図と注意点書く程度なので。(例えば:ここで速度稼ぎたい→再描画をoffしている。finallyでonし直すこと、など)。文書作成ならそれなりにコスト掛ける 2019-07-26T12:05:42Z 仕事 https://b.hatena.ne.jp/eru01/20190726#bookmark-4672049263013901058 なんやこのバイト数の無駄。釣りするならもうちょっとまじめにやれや。コメントにPython3.7の入れ方なんて書いてあったらその時点でこいつの座席ごとgit reset --hardやろ 2019-07-26T12:04:48Z https://b.hatena.ne.jp/msh5_h/20190726#bookmark-4672049263013901058 厳しいレビューで切磋琢磨できるチームに居るほうが伸びるよね 2019-07-26T12:00:46Z https://b.hatena.ne.jp/asozanhunka/20190726#bookmark-4672049263013901058 2019-07-26T11:56:18Z あとで読む https://b.hatena.ne.jp/sooooooma/20190726#bookmark-4672049263013901058 2019-07-26T11:53:36Z https://b.hatena.ne.jp/Tiantian/20190726#bookmark-4672049263013901058 2019-07-26T11:52:08Z https://b.hatena.ne.jp/htnmiki/20190726#bookmark-4672049263013901058 私はエンジニアではないので議事録の話をすると何社かで書いた経験から各社各現場で記述の粒度が違うので最初にそのレベル感を確認しないと二度手間になる。現場の作法が必ずあるからねえ。 2019-07-26T11:41:56Z https://b.hatena.ne.jp/shunutsu2-2-24/20190726#bookmark-4672049263013901058 2019-07-26T11:39:10Z あとで読む https://b.hatena.ne.jp/doobiedo222/20190726#bookmark-4672049263013901058 2019-07-26T11:21:37Z あとで読む https://b.hatena.ne.jp/hamati666/20190726#bookmark-4672049263013901058 はてブにあがるQiitaの記事は、ブコメで叩かれすぎてる気がするわ 2019-07-26T11:14:00Z https://b.hatena.ne.jp/aw91/20190726#bookmark-4672049263013901058 コメントは大事ではあるが、ここで挙げられている例が適当だとは思えない 2019-07-26T11:11:36Z https://b.hatena.ne.jp/u1-5300/20190726#bookmark-4672049263013901058 2019-07-26T11:05:14Z https://b.hatena.ne.jp/tatatayou/20190726#bookmark-4672049263013901058 2019-07-26T10:41:09Z あとで読む https://b.hatena.ne.jp/honma200/20190726#bookmark-4672049263013901058 "新人が入ってくるたびにコードレビューやドキュメントレビューで繰り返しています。" そら新人だからな。解決策は1と2で、チームの言語に合わせるくらい。7とかはOSSでもFIX:とかclosed:とか使うからねぇ 2019-07-26T10:33:02Z https://b.hatena.ne.jp/tksuuu/20190726#bookmark-4672049263013901058 2019-07-26T10:18:46Z あとで読む https://b.hatena.ne.jp/kenhtn/20190726#bookmark-4672049263013901058 2019-07-26T10:15:26Z https://b.hatena.ne.jp/sfw_sugahara/20190726#bookmark-4672049263013901058 2019-07-26T10:14:26Z https://b.hatena.ne.jp/yk5656/20190726#bookmark-4672049263013901058 2019-07-26T10:13:35Z コード https://b.hatena.ne.jp/kyompi/20190726#bookmark-4672049263013901058 2019-07-26T10:10:55Z programming https://b.hatena.ne.jp/gabill/20190726#bookmark-4672049263013901058 こういうのにこだわり始めたらなんかの兆候だと思う。 2019-07-26T09:54:56Z https://b.hatena.ne.jp/paradisemaker/20190726#bookmark-4672049263013901058 ものすごく大事なこと 2019-07-26T09:53:29Z https://b.hatena.ne.jp/kazuya030/20190726#bookmark-4672049263013901058 2019-07-26T09:52:53Z https://b.hatena.ne.jp/mirabakesso-0w0/20190726#bookmark-4672049263013901058 2019-07-26T09:48:39Z あとで読む https://b.hatena.ne.jp/naopi_chan/20190726#bookmark-4672049263013901058 2019-07-26T09:47:49Z あとで読む https://b.hatena.ne.jp/ode-h/20190726#bookmark-4672049263013901058 2019-07-26T09:40:04Z あとで読む https://b.hatena.ne.jp/Tomato-360/20190726#bookmark-4672049263013901058 大変そうだなって思った。コミュニケーションが足りないのかも。 2019-07-26T09:28:33Z 日本語 https://b.hatena.ne.jp/madta/20190726#bookmark-4672049263013901058 2019-07-26T09:14:48Z https://b.hatena.ne.jp/Lumin/20190726#bookmark-4672049263013901058 死ぬほどどうでもよくてワロタ。こんなことレビュー時に何度も言う奴がいたら即無能認定だし、そもそもコメントに書かないような例ばっかり挙げてるのどうなの 2019-07-26T09:13:41Z https://b.hatena.ne.jp/tofy/20190726#bookmark-4672049263013901058 そういうことならもうなんか英語で書いたほうがいい気がする 2019-07-26T08:56:13Z https://b.hatena.ne.jp/sanpatsu/20190726#bookmark-4672049263013901058 2019-07-26T08:42:57Z https://b.hatena.ne.jp/ppine/20190726#bookmark-4672049263013901058 2019-07-26T08:37:51Z https://b.hatena.ne.jp/fuji_haruka/20190726#bookmark-4672049263013901058 レビューコメントでこういう日本語の問題を指摘されるとイラッとは来るけど、各々が個人的に気をつけるのは良い習慣と思う。 2019-07-26T08:37:39Z https://b.hatena.ne.jp/Nyoho/20190726#bookmark-4672049263013901058 助動詞のところ助動詞じゃなかった。日本語わかってない可能性がある。 2019-07-26T08:32:39Z https://b.hatena.ne.jp/L3msh0/20190726#bookmark-4672049263013901058 2019-07-26T08:27:22Z あとで読む https://b.hatena.ne.jp/tetsutani006/20190726#bookmark-4672049263013901058 2019-07-26T08:27:02Z https://b.hatena.ne.jp/huyhuythutyhu/20190726#bookmark-4672049263013901058 2019-07-26T08:25:42Z あとで読む https://b.hatena.ne.jp/kirshenbaum18/20190726#bookmark-4672049263013901058 そもそも日本語でコメント書くの…。 英語のコメントの例の方がありがたい 2019-07-26T08:13:51Z https://b.hatena.ne.jp/tsaitoht/20190726#bookmark-4672049263013901058 2019-07-26T08:11:18Z https://b.hatena.ne.jp/ponnao/20190726#bookmark-4672049263013901058 2019-07-26T08:07:33Z https://b.hatena.ne.jp/fujixe/20190726#bookmark-4672049263013901058 「2. 方言・業界用語を使わない」Japanese joke! 2019-07-26T08:05:49Z https://b.hatena.ne.jp/ooshiro01/20190726#bookmark-4672049263013901058 ４はたしかに例が悪い。Pythonの入れ方なんてググればわかる。でも社内ライブラリのHogeHogeが必要とかそういう例だったら納得したと思う。…でもそれコメントよりドキュメントに書けって気はするけどな。 2019-07-26T08:00:10Z https://b.hatena.ne.jp/masahiror/20190726#bookmark-4672049263013901058 “「対応」”という文言は削ってはいけないと思うけどなぁ。覚書コメなのか実際に対応したのか、時間立つと誰もわからなくなるよ。 2019-07-26T07:58:02Z https://b.hatena.ne.jp/kane_to_onna/20190726#bookmark-4672049263013901058 2019-07-26T07:57:29Z