リーダブルコード 5-6章 コメントについて · GitHub
readable-code-chap5-6.md 5章 コメントすべきことを知る コメントの目的は書き手の意図を読み手に知らせることである コメントすべきでないことを知る コードを書いているときの自分の考えを記録する 読み手の立場になって何が必要かを考える コメントすべきではないこと パっとみて当たり前にわかることをコメントに書かない // 休日を計算する function caliculateHoliday() { ... } // 関数実行時の年の1/1から12/31まで、祝日を除く休日を計算する function caliculateHoliday() {....} コメントにパッと見でわからないことを書くようにしよう 関数名がひどい場合はコメントではなく関数名を書く // Kintoneのカスタマイズでコメントを128kbに制限する // コメントにはコメント内容、コメント時刻、コ
IT界隈の動物たち
GitHubの謎生物が気になり、せっかくなのでIT界隈の動物(?)を用いた名前やロゴの由来など調べてみた。 ※追記あり：Gopherファンに襲われそうなので。ごめんねGopher君 GitHub種類：octocat（ネコ＋タコ） 名前：monalisa Q.どうしてタコなのに8本足じゃないの？ A.なにも考えずに描いたからね！ もともとデザイナーはoctopussと呼んでいたが、いくら訂正してもGitHubの社員がoctocatと呼ぶため、octocatで落ち着いた。 octocatはあの生物種の名称であり、monalisaという名前は社員の娘が学校の課題で名付けたもの。 Python種類：ニシキヘビ 名前： - イギリスのコメディ番組『空飛ぶモンティ・パイソン』より。 またPythonという英単語はニシキヘビを意味するため、マスコットとしてヘビが用いられる。 オライリーの本とかすごい表紙
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
