Rubyコミッター・Yuguiに学ぶ、コードに書くべき「適切なコメント」と「適切な場所」 - エンジニアHub｜Webエンジニアのキャリアを考える！
Rubyコミッター・Yuguiに学ぶ、コードに書くべき「適切なコメント」と「適切な場所」 Rubyコミッター・園田裕貴（Yugui）さんが、長年の経験で体得したソースコードに書くべき「コメントの技法」を教えてくれました。 プログラミングにおいて、どんな初心者でも書けるけれど、適切に書くのは上級者でないと難しいもの。それがコメント（=ソースコードに書かれている注釈やメモ）です。 不適切なコメントをつけても、プログラムの動作には影響しません。しかし、書き方の巧拙によって、コードの可読性や理解のしやすさには雲泥の差が出ます。良質なコメントが良質なコードをつくるのです。 今回はRubyコミッターでありgrpc-gatewayの開発者でもあるSupership株式会社の園田裕貴（Yugui）さんに、優れたエンジニアがどんな観点を持ち、どんなコメントを書いているのかを聞きました。 園田 裕貴（そのだ・
コメント：コメントすべきこと：コードに対する考え - Strategic Choice
どういうこと？コメントには、コードに対する「大切な考え」を記録します。どうして？コードに対する「大切な考え」が書いてあるコメントは、コードの理解に大きく貢献します。映画のDVD にはよく「監督のコメンタリー」がついてきます。映画の製作者が自分の考えや物語について語ってくれるので、作品がどのように作られたのかを理解するのに役立つのです。これと同じように、「コードに対する大切な考え」をコメントに記録すると、コードの理解を助けることになります。どうすれば？コードに対する自分の考えを、コメントとして付記します。例えば、以下のようなイメージです。 // このデータだとハッシュテーブルよりもバイナリツリーのほうが40% 速かった。 // 左右の比較よりもハッシュの計算コストのほうが高いようだ。 コメントから情報を得ることができるので、下手に最適化しようとして無駄に時間を使う必要がなくなります。さらに、
undo-tree.elを小さいwindowで実行して終了時にもとのwindowに戻るようにする - hitode909の日記
undo-tree.elが便利で，しばらく使っていたのだけど，気になることがあった． てきとうにwindowを分割していると，思わぬところで実行されることがある 終了しても，もとのwindowに戻らないので，手動でもとのwindowに戻る必要がある ので，以下のように変更した． 右端に小さいwindowを作って，そこで実行する 終了すると元のwindowに戻る もとの関数をwrapするような感じにできればよかったのだけど，Emacs Lispを書いたことがなくて，よくわからなかったので，もとの関数を書き換えた． もともとgitで開発されてたので，勝手にgithubに置いた． hitode909/undo-tree · GitHub 参考 undo-tree.el の導入 - とりあえず暇だったし何となく始めたブログ 追記 Emacs 23では正しく動かないようです(直したいです…………)．
count-up - trotrの日記
http://d.hatena.ne.jp/kitokitoki/20091219 http://d.hatena.ne.jp/gongoZ/20091222 (defun count-up (d) (interactive "P") (when (looking-at "[0-9.]") (let ((col (current-column)) (beg (progn (skip-chars-backward "[0-9.]") (point))) (end (progn (skip-chars-forward "[0-9.]") (point)))) (let ((num (delete-and-extract-region beg end))) (insert (format "%s" (+ (string-to-number num) (or d 1))))) (move-to-c
はてなグループの終了日を2020年1月31日(金)に決定しました - はてなの告知
はてなグループの終了日を2020年1月31日(金)に決定しました 以下のエントリの通り、今年末を目処にはてなグループを終了予定である旨をお知らせしておりました。 2019年末を目処に、はてなグループの提供を終了する予定です - はてなグループ日記 このたび、正式に終了日を決定いたしましたので、以下の通りご確認ください。 終了日: 2020年1月31日(金) エクスポート希望申請期限:2020年1月31日(金) 終了日以降は、はてなグループの閲覧および投稿は行えません。日記のエクスポートが必要な方は以下の記事にしたがって手続きをしてください。 はてなグループに投稿された日記データのエクスポートについて - はてなグループ日記 ご利用のみなさまにはご迷惑をおかけいたしますが、どうぞよろしくお願いいたします。 2020-06-25 追記 はてなグループ日記のエクスポートデータは2020年2月28
はてなブログ | 無料ブログを作成しよう
新米と秋刀魚のわた焼き お刺身用の秋刀魚を買いました。1尾250円です 3枚におろして、秋刀魚のわたに酒、味醂、醤油で調味して1時間ほど漬け込み、グリルで焼きました 秋刀魚のわた焼き わたの、苦味が程よくマイルドに調味され、クセになる味わいです 艶やかな新米と一緒に 自家製お漬物 土…
英語版：Google検索で｢夫｣の後にスペースを入れると・・・: 駄文と書評
痛いニュース(ﾉ∀`):Google検索で｢夫｣の後にスペースを入れると・・・ を見るとこんな結果だったようだ。 夫 死んで欲しい 夫 嫌い 夫 小遣い 平均 夫 言葉の暴力 夫 小遣い 夫 呼び方 夫 死亡 手続き 夫 うつ 夫 失業 夫 死亡 年金妻 誕生日プレゼント 妻 誕生日プレゼント ランキング 妻 プレゼント 妻 ヒステリー 妻 呼び方 妻 うつ 妻 プレゼント ランキング 妻 謙譲語 妻 未届 妻 焼酎 まあ、悲惨な結果。これは日本の現状なのだが海外の英語圏の場合はどうだろう？ husband pillow husband quotes husband poems husband and wife husband in spanish husband birthday ideas husband jokes husband and wife making love husba
print-buffer - ごくまれに使用する Emacs コマンドシリーズ - higepon blog
ごくまれに使用する Emacs コマンドを不定期で紹介。 print-buffer：バッファを印刷する。 Emacs のバッファを印刷する事なんて滅多にないが、半年に一度くらい役立つ。 そういうコマンドに心当たりがある方はぜひご紹介ください。（トラックバックなど歓迎） マニアックであればある程喜びます（誰が？） 情報提供いただいた物 id:m-hiyama さん C-x 8 ' a とか what-cursor-position EmacsとUnicode文字で遊ぶ - 檜山正幸のキマイラ飼育記 what-cursor-position おもろい。 id:yoozoosato さんM-x gomoku これ見て M-x doctor を思い出した。 id:kitokitoki さん 標準関数 indent-rigidly の紹介 - ポロポロ
はてなグループの終了日を2020年1月31日(金)に決定しました - はてなの告知
はてなグループの終了日を2020年1月31日(金)に決定しました 以下のエントリの通り、今年末を目処にはてなグループを終了予定である旨をお知らせしておりました。 2019年末を目処に、はてなグループの提供を終了する予定です - はてなグループ日記 このたび、正式に終了日を決定いたしましたので、以下の通りご確認ください。 終了日: 2020年1月31日(金) エクスポート希望申請期限:2020年1月31日(金) 終了日以降は、はてなグループの閲覧および投稿は行えません。日記のエクスポートが必要な方は以下の記事にしたがって手続きをしてください。 はてなグループに投稿された日記データのエクスポートについて - はてなグループ日記 ご利用のみなさまにはご迷惑をおかけいたしますが、どうぞよろしくお願いいたします。 2020-06-25 追記 はてなグループ日記のエクスポートデータは2020年2月28
symfony book 日本語ドキュメント アドミンジェネレーター
概要 バックエンドアドミニストレーションはしばしばフロントエンドのアプリケーションで利用されているデータ構造に従って構築されます。そのようなバックエンドは symfony によって作成されることができ、定義されたオブジェクトモデルが提供されます。このように動作するメカニズムはアドミン ジェネレーターと呼ばれています。カスタム設定のシステムを使うための多くの繰り返される作業を自動化します。また、全体的な制御を行うことができ、全ての生成されたコンポーネントと、アプリケーションの見た目や感じをカスタマイズまたは拡張することができます。そして、アドミンジェネレータは完全にあなたの要求にこたえることができないとき、あなた自身のコードをアドミンジェネレータに組み込むするためのツールを提供します。 注意: ダウンロードできるアドミニストレーションの構築の様子を見ることができるスクリーンキャストがあります
Emacs Powered - Emacs/Lisp/Drill - Emacsグループ
はてなグループの終了日を2020年1月31日(金)に決定しました 以下のエントリの通り、今年末を目処にはてなグループを終了予定である旨をお知らせしておりました。 2019年末を目処に、はてなグループの提供を終了する予定です - はてなグループ日記 このたび、正式に終了日を決定いたしましたので、以下の通りご確認ください。 終了日: 2020年1月31日(金) エクスポート希望申請期限:2020年1月31日(金) 終了日以降は、はてなグループの閲覧および投稿は行えません。日記のエクスポートが必要な方は以下の記事にしたがって手続きをしてください。 はてなグループに投稿された日記データのエクスポートについて - はてなグループ日記 ご利用のみなさまにはご迷惑をおかけいたしますが、どうぞよろしくお願いいたします。 2020-06-25 追記 はてなグループ日記のエクスポートデータは2020年2月28
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
カーソルの位置にある数字列をインクリメントする emacs lisp 改修 - Thanks Driven Life