2019年7月31日のブックマーク (1件)

  • レビュー前に直して欲しい日本語の問題点8つ - Qiita

    私はウンザリしています。 「○○対応」は曖昧なのでやめてください。「○○を修正した」の方が直接的です。 こんな指摘を新人が入ってくるたびにコードレビューやドキュメントレビューで繰り返しています。どうも、プログラマー(と言うか理系?)には独特の言語文化があり、みんな同じような分かりにくい表現をしてしまうようです。 「レビューを依頼する前にこれを読んどいて!」と言える記事なりなりがあれば良かったのですが、良いものが見つけられなかった(ご存知なら教えてください)ので、とりあえずレビューでよく指摘する日語の文章の問題点や変な表現ポイントを列挙しました。 なお「コメントは必要十分な量を書く」「チケット番号やWikiのURLを書く」といった、良く知られた・日語に限定されない話題は省略しています。 (※コメント欄などの指摘を受け「補足」を追加) (※タイトル変更。「コードレビュー前に直して欲しい日

    レビュー前に直して欲しい日本語の問題点8つ - Qiita
    treeapps
    treeapps 2019/07/31
    人間にこれらを指摘されると嫌な気分になって反発されそうなのと、その人独自の言葉遣いを強要するだけで終わりそうなので、どうしてもやるならRedPen等で機械的に緩めにチェックする仕組みとかを作った方がよさそう