ya_yoheiのブックマーク - はてなブックマーク

オクトキャットはオープンソースではない
昨今のオープンソースを推進する象徴であり、開発者の大好きなGitHubとそのキャラクターであるオクトキャット(octocat)。皆さんもステッカーやTシャツ、フーディーの入手に努めていると思いますが、そのライセンスについてはあまり知られていないのではないでしょうか？さまざまなオクトキャットのバリエーションを展示しているoctodexのFAQページにはそのライセンスについての記載があります。原文はサイトを参照して頂くとして、下記のような内容です。(強調は訳者) Q: オクトキャットを私のウェブサイトで使えますか? どのように使おうとしているかによりますが、多分使えます。もし”GitHub上で見る”というGitHubへのリンクのようにGitHubを参照する為に使う場合は全く問題ありません。しかしGitHubではないプロダクトを参照する際にオクトキャットを使うのはフェアユースではありません。
ya_yohei 2013/01/30
octocats

github
リンク
API設計に関する10のワーストプラクティス
過半数の開発者が平均で3つ以上のAPIのインテグレーションを実装していると言われている昨今、「使い辛い設計のAPI」を実装するのは開発者にとっては頭の痛い問題ではないでしょうか？ Programable Web上に投稿されたAPIのワーストプラクティスに関する記事が国内外の開発者の目に止まったようです。この記事によると悪いAPIに見られるプラクティスは下記のようなものだそうです。貧弱なエラーハンドリング HTTPのルールを無視したREST API 裏に潜んだ生のデータモデルの露出セキュリティの複雑さドキュメント化されていない予期せぬリリース貧弱なデベロッパエクスペリエンス MVCフレームワークが良いAPIにしてくれるという思い込み開発すれば使ってもらえると見なすこと不十分なサポート貧弱なドキュメンテーション APIを利用するだけでなく、APIを提供する場合に上記のようなポイン
ya_yohei 2013/01/13
api

programming

development
リンク
GitHub直伝プルリクエスト活用の3つのコツ
GitHubの特に重要な機能である「プルリクエスト」の活用方法についてGitHub社内でのノウハウが公式ブログの記事になっていました。GitHubが今回更新をしたAboutページの開発でも2ヶ月の間に10人のメンバーが130のコミットと91のコメントのやりとりがブランチ上で行われていました。 GitHubberによる講演などでもプリリクエストが重要な機能であると強調されているようです。記事によるとプルリクエストは新しいアイデアについてのディスカッションを生み、協力してくれる人を見つける為のとても良い方法との事で活用するコツとして以下の3つの点を紹介しています。プルリクエストはなるべく早く起こすプルリクエストは機能についての意見交換をする良いきっかけになります。コードの修正が終わっていなくてもなるべく早くプルリクエストをする事で、最後にまとめてフィードバックをするのではなく発展的にコメ
ya_yohei 2012/05/06
git

github
リンク
1