タグ

2017年6月3日のブックマーク (1件)

  • コーディングするとき・プルリクにコメントするときの観点 - s平面の左側 - s平面の左側

    2年目、3年目と時が経つにつれて、他人が書いたコード見てコメントをする機会は増えていく。 このときに(主にコーディングに関する)自分の考え方を言語化して他人に伝える、というのはとても骨が折れる作業だ。 そこで、これまでに他人にしてきたコメントを思い返しつつ「普段どんなことを考えながらコーディングしているか」「プルリクを見るときにどんなところを見ているか」という観点を整理してみた。 もちろんただ文字に起こしただけでは伝わらない。 何度も繰り返し改善案のコードとセットにして伝える、という積み重ねの先に観点・感覚が身につくはずだと信じている。 ※この記事では主に「バグが発生しにくいこと」「バグが発生しても原因を特定しやすいこと」を目的としている。 ※具体的なコード例を載せると長くなるので割愛。文字での説明のみ。わかりにくいのは承知の上。 目次 目次 名付けについて 引数について 戻り値について

    コーディングするとき・プルリクにコメントするときの観点 - s平面の左側 - s平面の左側
    pinkumohikan
    pinkumohikan 2017/06/03
    実装時、レビュー時の観点 ver.okashoi