大学の図書館にて”良いコードを書く技術”という本があったので、 感想とともに自分の体験などを交えて偉そうに話していこうと思う。本の全ては扱っていません。 ※また章の順番も一部変えています。 目次 １章　良いコードとはなにか ２章　良いコードを書くための５つの習慣 ３章　名前付け ４章　スコープ ５章　コードの分割 ６章　コードの集約化 まず良いコードとはなんだろうか？ 例えば宿題で書くコードを例にしたら、課題だから答えがあって、求められているものをクリアすることを優先すると思う。そんなの誰だってそうなので当たり前だ。なのでコメントも殆ど書かないし。読んでもらう相手は先生なので分かってくれるだろうと思って書いている。 私も普段から気をつけたいと思っているが、注意すると良いポイントは読む相手のことを考えることだと思う。他の本を見ると難しいことが書いている。でも重要な事は読み手を意識することだと

この記事について この記事は筆者がプリンシプルオブプログラミングを読んで、備忘録的にまとめたものです。 これから紹介する６つの原則を用いて、「よいプログラマ」に近づきましょう！ 新人プログラマが知るべきプログラミングの原則7選 KISS Keep It Simple,Stupid シンプルにしておけ、愚か者よ コードを書くとき、「単純性」や「簡潔性」を最重要項目ということ。 コードは、自然に任せて修正していくと、無秩序になり、複雑になる。その結果、読みにくく、修正しにくくなっていく。コードをシンプルに保つことで、修正に容易にすることができる。 具体的には、プログラミングをする際に、「動作させるために、もっともシンプルなものは何か」と常に問いかけることが必要である。 DRY Don't Repeat Yourself. 繰り返すな。 同じコードを重複して書くなということ。 なぜかというと、コ

弊社に５年間在籍していたロシアの天才ハッカーが先日退職しました。 ハッキング世界大会優勝の経歴を持ち、テレビ出演の経験もある彼ですが、正直こんなに長く活躍してくれるとは思っていませんでした。彼のようなタレントが入社した場合、得てして日本の大企業にありがちな官僚主義に辟易してすぐに退職するか、もしくはマスコットキャラとして落ち着くかのどちらかのケースがほとんどなのですが、彼は最後まで現場の第一線で活躍してくれました。 そんな彼が最後に残していった退職メールがなかなか印象的だったので、その拙訳をここに掲載します（転載について本人同意済み。弊社特有の部分は一部省いています。） ああ、なんという長い旅だったろう。この会社で５年間もセキュリティを担当していたよ（諸々の失敗は許してくれ） 俺は他の退職者のように面白いことは書けないが、私のこの退職メールを読んでくれている人、特に新人エンジニアのために、

レンタルサーバなら「さくらのレンタルサーバ」！ 月額換算でわずか129円、缶ジュース1本分のお値段で使える格安プランから、ビジネスにも使える多機能＆大容量プランまで、 用途と予算に合わせてプランを選べます。 さらにマルチドメイン対応でメールアドレスも無制限。無料ウイルススキャンや無料電話サポートもあるので安心して ご利用いただける共用レンタルサーバサービスです。

レンタルサーバなら「さくらのレンタルサーバ」！ 月額換算でわずか129円、缶ジュース1本分のお値段で使える格安プランから、ビジネスにも使える多機能＆大容量プランまで、 用途と予算に合わせてプランを選べます。 さらにマルチドメイン対応でメールアドレスも無制限。無料ウイルススキャンや無料電話サポートもあるので安心して ご利用いただける共用レンタルサーバサービスです。

はじめに：「僕にもそんな頃があった」 先日、西脇.rb＆神戸.rbの合同勉強会として「RailsプログラマのためのSQL勉強会」を開催しました。 この勉強会は出題者（＝僕）が出したSQL問題を他の参加者が解く、というスタイルの勉強会です。 参加者の方の中には最近プログラミングを始めた、という人も何人かいました。 そういう人にとっては問題がちょっと難しかったので、ときどき僕がサポートに回って質問に答えたり、解き方をある程度教えたりしていました。 また、話がちょっと脱線して「僕が作ったこれぐらいのWebアプリは、伊藤さんなら何時間ぐらいで作れますか？」みたいな質問を受けたりもしました。 その中で言われたのが、 「説明されたらわかるけど、自分一人でこの答えにたどり着くのは無理です」 「えっ、そんな短い時間で作れるんですか」 といったようなコメントです。 そういったコメントを聞くと、「あー、僕にも

とある学生さんがプログラミングの勉強をしたいということで、良い自習の方法はないか？という相談をしていました。初心者が「自習」でプログラミングを学ぶことは、どうすれば効率的なのかを、改めて考えて回答しました。 私のおすすめ学習法は「写経」という方法です。プログラマの間では今となっては割とポピュラーな学習法ですが、初心者にとってもすごく効果的だと思うので紹介しておきます。 プログラミングは知識と身体の両方が必要 まず、プログラミングをしたことのある人ならわかると思いますが、プログラミングは知識だけを身につければ出来るようになるものではありません。学校教育における歴史や地理のように猛勉強で覚えれば出来るようになる訳ではないです。 もちろん、学ぶプログラミング言語の文法や基本的なAPIについては覚えているにこしたことはありませんが、それらを覚えることはそこまで重要ではありません。 プログラミングは

Gitのコミットメッセージの書き方 自分なりにまとめてみました。Git歴浅いので、意見募集中です。 （2014年12月17日追記） 想像以上にたくさんの方にストックなりはてブなりいただいたので、はてブでなるほど！と思ったコメントをもとに少し修正・加筆してみました。 （2022年1月4日追記） 最新の書き方をこちらに書きました。 https://zenn.dev/itosho/articles/git-commit-message-2023 原則 以下のフォーマットとします。 1行目：変更内容の要約（タイトル、概要） 2行目 ：空行 3行目以降：変更した理由（内容、詳細） 日本語でも英語でもOKですが、リポジトリで統一してください。 1行目 コミット種別と要約を書きます。フォーマットは以下とします。 [コミット種別]要約 コミット種別 以下の中から適切な種別を選びます。 （多すぎても悩むので

注意 この記事は、2014年に投稿されたものです。 時代は変わっても運用におけるベースは大きくは変わっていませんが、投稿としては古い内容ですのでご注意下さい。 未だにストックなど多くいただきますので注意事項として、追記させていだきます。 以下本文です。 はい、今更かもしれませんが。俺としてはGitを扱う上で結構重要だと思っている commitやpushの頻度 について書きたいと思います。はじめに断っておきますが技術的なテクとかの話ではないです。ほとんどが 言われてみれば当たり前じゃん 程度の内容だと思って下さい。 ですが、flowとか運用方法 とか gitを使いこなすちょっとしたテク なんかより重要だと思っているのは俺だけでしょうか...？ どの単位でコミットしたりプッシュしていますか？ みなさん、どのような単位でコミットしたりするようにしていますか？未だに 適当にやってる みたいな人がい

長男(今年9歳)が通っている学校は、かなり宿題が多い学校のようで、低学年でもそれなりの量の宿題が出ます。当然、夏休みの宿題も結構な量です。 長男は、普段の勉強については特に苦労をしていないようですが、やはり小学生であって、計画的に宿題をするのは苦手です。 一年生の時の夏休みの宿題も、結局すべて片づけるのはかなりギリギリになっていたようで、8月下旬くらいに泣きべそをかきながら宿題をやっているのを観測しました。 小学校の宿題に親が口出しするのもどうかなと思いまして、一年の頃はあまり干渉しなかったんですが、ちょっとそれを見て反省というか、考えを改めました。 宿題の本来の意味は、「家庭での勉強の習慣を作ること」だと思います。それが機能しないばかりか、単に嫌な思い出ばかりになってしまい、机に向かうこと自体がイヤになってしまったら可哀想だなーと思ったからです。 そこで、2015年の夏休みは、多少干渉し

この記事はリクルートライフスタイル Advent Calendar 2015 - Qiita の17日目です。 こんにちは。現在、ホットペッパーグルメのエンジニアをやっている敷地@shikicheeです。 gitで英語のコミットメッセージどう書けばいいの？ と思ったことはありませんか？ 英語で書きたいなーって思っても、いざ書くとなると躊躇しますよね。 ネイティブはどう書いてるのでしょうか。 そこで、github上で実際に使われているコメントを解析し、 よく使われている例をまとめてみました。 解析したデータ github上で1万スター以上を獲得している169リポジトリのコミットメッセージを対象としました。 bootstrap、jquery、react、d3、docker、node、tensorflowなどの有名なプロジェクトばかりなので、良いコメントが期待できます。 解析するコミットメッセー

プレゼンテーションはいくつかのポイントを押さえれば、大幅に分かりやすく、説得力があり、オーディエンスの心を掴むものになる。今回はパワーポイント等でのプレゼン資料の作り方のポイントを５つに分けて紹介する。 1. 作り出す前に構成をざっくりと考える 聴く人の腹に落ちるプレゼンテーションをしたければ、まず構成を練ろう。行き当たりばったりで、思い付いたことをスライドにまとめると、最も伝えたいメッセージが薄れてしまったり、論理構造が狂ってしまう可能性があるからだ。一方で、実際に手を動かしてスライドを作っていく中で良い表現は浮かんでくるのも事実。 そこで最低限、あらかじめ次の2つをざっくり書き出すようにする。 最も主張したいメッセージ (結論） プレゼンのどこかしらに盛り込みたいこと 次に、書き出されたものを見ながら、どうやって(1)結論までのストーリーを作るか考える。以下に、そのストーリーの代表的な

BEMによるフロントエンドの設計 第1回 基本概念とルール この記事ではフロントエンドの設計方法「BEM」を紹介します。第1回目はBEMのもっとも基本となるBlock、Element、Modifierの概念と、class名の命名ルールを解説しています。 はじめに 最近フロントエンド界隈で、『BEM』という言葉を見かけることが増えてきました。BEMとは、Block、Element、Modifierの略語です。Webサイトのコンポーネント化のためのフロントエンド設計方法のひとつで、厳格なclass名の命名ルールが特徴的な手法です。 第1回は、BEMをまったく知らない方向けの入門編です。 なぜBEMが必要なのか 私たちはHTMLとCSSを使うことでしか、Webサイトを作ることができませんが、HTMLとCSSにはプログラム的な機能が備わっていません。そのために、フロントエンドエンジニアは次のような

コードレビューで土日に安寧を ソーシャルゲームは、ユーザアクセス集中と、それに伴うユーザデータ増加によって劇的に負荷が上がり、（主に土日に）サービスに影響を与えがちです。 問題があるコードは、たとえ負荷テストを行っても、作成したシナリオによっては見つけられない可能性もあります。 そういった見えない不安を払拭するという意味でも、コードレビューは重要だと思っています。 【ステキポイント】 ・ ソースを見ることにより、時限爆弾が土日に爆発するのを解除 ・ スキル共有によってメンバーがレベルアップすることにより、土日に爆発する時限爆弾の設置確率低下 まぁまとめると これに尽きます（4歳の息子談） 今は、gitのプルリクエストという強力なレビューツールもあり、敷居がかなり低くなったのでオススメです！ チェックするポイントは5つ コードレビューを行うにあたり、「どんなところをチェックすればいいのか分か

前置き 正直に答えてください。 あなたが1日に集中してプログラムを書ける時間の長さは？ 12時間？11時間？9時間？ はい。 あなたはスーパープログラマーです。人間を超越していると言ってもいい。このポエムはなんの役にも立たないのでさっさとエディタに戻って人類の未来に貢献してください。 8時間？7時間？6時間？ 本当？ すごい。ほんとうにすごい。引き続き頑張ってください。きっとあなたはコードに選ばれた人です。 しかしあなたにもこのポエムは役に立ちません。 そっとブラウザのタブを閉じて頂ければと思います。 4時間？3時間？ はい。ようやくめぐりあえましたね。あなたのような方をお待ちしておりました。 こんなに集中していられる時間が短いなんて、問題があるのでは、、とお考えかもしれません。 後ろめたい気持ちにとらわれることがあるかもしれません。 その気持ちを埋め合わせるために、終電間際まで仕事し 「

Welcome to Underground という訳で今年から新人プログラマとして働く方、おめでとうございます。 この先、皆さんには 糞みたいな上司と争ったり、糞みたいな炎上プロジェクトに突っ込まれたり、糞みたいなクライアントの対応したり 素敵なイベントが沢山あることでしょう！ そんな皆さんにクズと自認している私が僭越ながら処世術をお教え致します。 学生時代からOSSに貢献してたり、スタートアップに潜入してたりする意識高い学生は回れ右してお帰りください。 クズなりの糞みたいな職場の乗りこなし方 大小様々な会社が古今東西色々とございますが、中には糞みたいな会社や糞みたいな部署や糞みたいなチームがあります。 そういったところへ自分が配属された時にはまず 次の転職先を探してください。 そのような現場に回されてしまっても無理してあなたはそこで働くことはありません。 さっさと転職しましょう。 え？