Rubyコミッター・Yuguiに学ぶ、コードに書くべき「適切なコメント」と「適切な場所」 - エンジニアHub｜Webエンジニアのキャリアを考える！
Rubyコミッター・Yuguiに学ぶ、コードに書くべき「適切なコメント」と「適切な場所」 Rubyコミッター・園田裕貴（Yugui）さんが、長年の経験で体得したソースコードに書くべき「コメントの技法」を教えてくれました。 プログラミングにおいて、どんな初心者でも書けるけれど、適切に書くのは上級者でないと難しいもの。それがコメント（=ソースコードに書かれている注釈やメモ）です。 不適切なコメントをつけても、プログラムの動作には影響しません。しかし、書き方の巧拙によって、コードの可読性や理解のしやすさには雲泥の差が出ます。良質なコメントが良質なコードをつくるのです。 今回はRubyコミッターでありgrpc-gatewayの開発者でもあるSupership株式会社の園田裕貴（Yugui）さんに、優れたエンジニアがどんな観点を持ち、どんなコメントを書いているのかを聞きました。 園田 裕貴（そのだ・
DISQUSに移行 - 世界線航跡蔵
このサイトのコメントシステムを TypePad Connect から DISQUS に移行した。幸いなことに(?)、まだコメントは頂いていなかったのでデータ移行は問題ない。 移行の理由は2つ。 もう1つは、DISQUSのほうがメジャーな雰囲気なので。この手の囲い込みサービスは結局勝ち馬に乗るのが良い。 API が用意されていて、あとで追加開発すればコメントのデータは自前で持てそう、というのが1つ。データを外部サービスに完全に依存して移行の方法もないのはやっぱりちょっと気持ち悪い。 スパムへの対処はもういい加減しんどいので、この手の外部サービスにコメントを管理させる流れは方向性として間違っていないと思う。それに、利用者としてもこうやって自分があちこちに付けて回ったコメントが自分のアカウントで一元管理される仕組みはうれしい。そして、DISQUSへのログインはFaceBookやGoogleのアカ
はてなブログ | 無料ブログを作成しよう
賃貸暮らしのわが家の地震対策【揺れから命を守る編】 以前のブログでも記載した、防災の優先順位に基づいて対策を進めています。まだ手をつけられていない部分もありますが、ある程度まとまってきたのでざっくりとご紹介していきます。 優先順位別に改善していっているため、今回は主に地震の揺れ対策がメインになります。…
にっき(2008-08-01)
_ tDiary用Yahoo!ショッピングプラグイン(2) ダウンロード - yshop.rb (EUC-JP) ほとんどの商品にJANコードがあるようですので、デフォルトの引数をJANコードにしました。 {{yshop_image '4934054780211'}} 涼宮ハルヒの憂鬱 涼宮ハルヒ ビーチサイドver. (1/7スケールPVC塗装済み完成品)[送料無料、代引不可] さらに、第２引数でストアIDを指定することができるようになりました。 {{yshop_image '4934054780211', 'bigbe'}} JANコードのない商品の場合、queryを使って商品名や商品コードなどでキーワード検索してください。 {{yshop_image :query => 'OCY1180'}} このプラグインについて詳しくはこちらをご参照ください。
tota diary(2008-04-17)
_ Firefox 2.0.0.14 更新 Tags: Firefox | | | | tweet | | Permalink _ tDiary 2.2.1.20080302 FOMAで500 Internal Server Error 帰りのバスで暇だったので自分の日記でも見てみようかと最新ページにアクセスすると500 Internal Server Errorになっていました。詳細には 500 Internal Server Error 400 Bad Request (OpenURI::HTTPError) /usr/local/lib/ruby/1.8/open-uri.rb:278:in `open_http' /usr/local/share/examples/tdiary-cvs/tdiary.rb:105:in `join' /usr/local/share/example
POsync 0.29a リリースしました(バグ対策） - とーふの買い物日記-改：楽天ブログ
2008.02.06 POsync 0.29a リリースしました(バグ対策） (9) カテゴリ：W-ZERO3ツール ver0.29 で組み込んだ処理のせいで異常終了することがあるのを対策しました。 ダウンロードは、こちら 原因は組み込んだ変換処理関数に対して、null が渡されることがあることに気が付いていなかったため。 google カレンダーの登録の仕方次第で発生する模様。 お気に入りの記事を「いいね！」で応援しよう いいね！0 シェアする 最終更新日 2008.02.06 21:35:07 コメント(9) | コメントを書く [W-ZERO3ツール] カテゴリの最新記事 ZERO3 などで POsync がエラーになる件 2009.12.08 コメント(3) POsync 0.31 リリース（ただし、ベータ版） 2009.04.21 コメント(2) POsync ver 0.30
MIAU 大感謝祭 - babie, you're my home
MIAU のページにアクセスしたら、なんかいきなりクリスマスの話してて、超面食らった。キチガイかと思った。一瞬ね。 開発者の端くれ(ほんとに端っこだぁ・・・)として言わせてもらうと、感謝の言葉などなくても、使ってくれるだけで嬉しかったりする。これって、ホント端っこの意見だな。
はてなのIDでOpenID対応サービスにログインできるようになりました - はてなダイアリー日記
本日はてなのIDで、LiveJournalなどのOpenID対応サービスにログインできるようになりました。 OpenIDとは様々なサービスで共通して使用できるURL形式のID（アカウント）で認証が可能な仕組みで、はてなのアカウントでもこのOpenIDに対応したURLを使ってログインできます。認証用のURLは以下の通りで「ユーザー設定」より「外部からの認証」を選択するといつでも確認できます。 http://www.hatena.ne.jp/ユーザー名/LiveJournalやMovable TypeなどのOpenIDでのログインに対応したサービスで、OpenIDでのログインを選択すると認証用URLを聞かれますので、上記URLを入力してください。はてなにログインしていない場合は1度はてなのログイン画面が表示されるのでログインすると、そのサイトでのログインを許可するか選択する画面が表示され「許可
2007-10-24
晴れ。 東大阪経由で職場へ。 疲れたな。午前中は忙しかった。 http://sho.tdiary.net/20071022.html#p01 tDiaryの作者、ただただしさんのブログより。 refererに、それを受け取る人が期待しないものを乗せたからと言って、とりたてて非難されることはないと思うし。（中略） まぁ、ゴミが見えるから気になるって人はいると思うけど、気にしないのが現代風です。 私も以前、tDiaryを使ったのだけれど、リファラスパムが気になり止めてしまった。 私はリンクも重要なコンテンツと考えている。少なくとも、誰かのコメントと同じくらい、或いはそれ以上に重要と思っている。 だから、自分の管理するウエブページからジャンプするその先は、自分でコントロールしたいと思う。つうか、責任を感じる。 私は結局tDiaryを使うのを止めたのは、リファラを隠せなかったから。（追記：tDia
AmazonLinkプラグイン
かつて自分がblosxomでブログやってた頃は、Amazonへのリンクを張るプラグインを自分で作ったものでしたが、WordPressではそこまでやる時間も知識も根性もまだないので、Amazonへのリンクを作成してくれるプラグインを導入することにしました。 今回導入したのは、AmazonLinkという名前のプラグインです。 ASINコードを入力してタグで囲むと、そこがAmazonへのリンクになるというもの。かつて自分がblosxomで作ったプラグインとノリが似ているので使ってみることにしました。 [amazon]4035401501[/amazon] 最近読み終わった本。男の子が妊娠する話です（すごい語弊） 同系のプラグインとしてはWP-Amazonというものもあったのでこちらも試してみたのですが、他にプラグインを一切入れていないにも関わらず動作しないため、こちらは導入を諦めました。バージョ
携帯電話の写真から位置情報がバレる話 - ARTIFACT@はてブロ
使用機種がバレバレ！ デジタル写真に残る個人情報に気をつけろ：デジタルARENA 位置情報大好き人間として、ちょっと気になったのでメモ。 ブログの画像からカメラ携帯の機種を調べてみる: blog.bulknews.net この記事は、miyagawaさんの記事をネタにしていると思うのだけど、Exifと違い、画像への位置情報の埋め込みは結構手間がかかる。GPS搭載携帯電話を持っている人はぜひ試して欲しいのだが、 撮影する前にGPSで位置を計測する（ここで15秒以上はかかる） カメラモードにして、位置情報を画像に埋め込むという設定にする やっと撮影 ぱっと出してすぐ撮影するのがメリットである携帯電話で、こんな手間のかかることを毎回やる気にはなるとは思えない。わざと位置情報を埋め込みたい人しかやらないだろう。 また、携帯電話で撮影した写真をブログに投稿する場合、メールでする人も多いと思うが、携帯
無料APIに関する6つの真実 - YAMDAS現更新履歴
O'Reilly Radar > Six Basic Truths of Free APIs OSCON などオライリーのカンファレンスを手がけ、また『Perlクックブック』（asin:4873112028、asin:4873112036）などの著書でも知られる Nathan Torkington が、ウェブサービスの無料 API についてシビアなエントリを書いている。 何せ、無料 API がオープンソースと同様に楽しみと実益の上に築かれた共有地だという考えは誤解だと喝破することから始まり、無料 API ほど高いものはない、という文章で終わるのだから。 これは以前取り上げた「Web 2.0 の無垢の終焉」話を受けたものだが、さかのぼること一年半ほど前、Google API をオープンスタンダードにしようという声に対して異議を唱えたただただ氏は偉かったということか。
透明性の低いコミュニケーション | smashmedia
ごめんなさい。smashmediaのブログは削除されました。 10年に渡り、あちらこちらに書き連ねてきましたが、ご愛読いただきほんとうにありがとうございました。またリンクしてくださった方にも、心からお礼申し上げます。 以下、少し駄文を書きます。 ブログには「パーマリンク」という基本的な考え方があり、すべての発言や記事は半永久的に固定されたURLによって公開され、未来におけるアクセス権（閲覧可能性）を担保するという、じつに素敵なコンセプトなのですが、一方で古い情報が永遠に残り続けてしまうという弊害も生んでいます。 ブログというものが「ストック」であるならば、そこに書かれた内容に対して、書き手であるブログ運営者は責任をもつべきで、自らの考え方が変われば内容を更新し、状況や情報が変われば現在にあわせて修正すべきです。 でも現実問題として、そこまでさかのぼって更新や修正をできるほうが稀で、結果とし
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
サービス終了のお知らせ
tDiaryをutf-8化してみたい - @author pyridoxin
へー、こんな書き方もあったんだ - crkの独り言
午後から参加 - 年に何度か
http://d.hatena.ne.jp/mikihoshi/20070728/1185630309
http://materia.jp/blog/20070507.html
http://syamco.flop.jp/blog/2007/05/06/re_outline_of_idol_developing_8/