ソースコードはしゃべるように書け - Qiita
はじめに この記事は、僕が配属当初に先輩からよく言われた「ソースコードはしゃべるように書け」について、それが具体的に何を意味するのかを、配属から6年経った今改めて考えてみる記事です。 その先輩はすでに辞め新しいステップへ進まれてしまったためにその真意を直接聞き直して確認することはできないのですが、今の僕なりの解釈、ということで書いてみます。 とは言え、「ソースコードはしゃべるように書け」は「ソースコードの読みやすさ」という意味では役に立つ考え方ですが、それがどんな場面でも正しいかというとそうではないと思っています。おそらく、自然言語に近づけた書き方よりも、より機械の仕組みに近づけた書き方をした方がはるかに効率がよかったり、安全な言語や場面もあると思います。 また、仕様自体が複雑だったり、既存のソースがすでに汚いなどの理由で、この記事に書いたようなことがすんなり実行できる環境というもの自体が
プルリクでやられると困っちゃうことまとめ - Qiita
Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article? 最近めっきり便利屋さんみたいなポジションになってしまい、サーバーにしろアプリにしろ「プルリクお願いします」と言われることが多くなってきました。 僕もスーパーなエンジニアでは全くないのであれこれ試行錯誤しながらコードを見ているのですが、今回はそんな中でやられると困っちゃう（オブラート10枚くらいで包んだ表現）ことをまとめます。 ちょっと困っちゃうやつ プルリクの説明がコミットログ（しかもテキトーに書いたやつ）の羅列 プルリクのタイトルがない 改行コードが変わったのか、ファイル全体が差分になる 明らかに不要なコメントアウトが残ってる 個人的
プルリクでやられると嬉しいことまとめ - Qiita
Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article? 前回プルリクでやられると困っちゃうことまとめという記事を書いたのですが、これだけ読むとプルリク嫌いな人みたいな印象を与えてしまうような気がしてきたので、反対に嬉しいことをまとめてみました。 （プルリクを見ること自体はどちらかというと好きです。） ではどうぞ。 ちょっと嬉しいこと 「こんなプルリク出すので確認をお願いします」を口頭で言われる 複雑な処理、イレギュラーな処理に対し、「なぜこんなことをする必要があるのか」がコメントされている 嬉しいこと 指摘に対し、こうこうこういう意図があってこうしたのですがどうでしょうか、と前向きに議論して
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
