2019年7月26日のブックマーク (2件)

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

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

    レビュー前に直して欲しい日本語の問題点8つ - Qiita
    fuji_haruka
    fuji_haruka 2019/07/26
    レビューコメントでこういう日本語の問題を指摘されるとイラッとは来るけど、各々が個人的に気をつけるのは良い習慣と思う。
  • 数学の文章題が読めない、家に本がない。そんな子の家庭教師で「あること」をしたら数学と国語の成績が上がった話

    bao @baobabustroll 中学生の家庭教師をした時に、数学の文章題の意味が汲み取れない子がいた。家にコミックと教科書以外のが無い。唯一電子レンジに付属してるレシピブックがあったので「親御さんに質問せずにレシピブックだけ読んで料理を作ってごらん」って指示してみたら数学と国語の成績が上がった。 2019-07-25 10:58:12 bao @baobabustroll 親御さんからは「数学の定期テストの成績を上げてくれ」って希望されたけれど、小学4年辺りで置き去りにされたままだと感じたので、レシピの読み解きと小4の復習から始めた。3カ月で「成績は上がったけど、数学の指導以外の事をするから」とクビになっちゃって、顧客満足度評価の難しさを知った。 2019-07-25 11:04:29

    数学の文章題が読めない、家に本がない。そんな子の家庭教師で「あること」をしたら数学と国語の成績が上がった話