タグ

ブックマーク / tech.a-listers.jp (3)

  • API設計に関する10のワーストプラクティス

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

    API設計に関する10のワーストプラクティス
    ramtiga
    ramtiga 2013/01/12
  • ターミナルからHacker Newsが見れるGem

    でも引き続き認知の高まっているHacker Newsをコマンドラインから閲覧できるGemが話題になっていました。導入はとても簡単です。 gem install hacker_term hacker_term 最近のGemはウェブサービスのクライアントやHTMLCSSのコーディングに使うツールなどもはやRubyにとどまらない汎用ツール化してきていますねぇ。 via:https://github.com/ciaranarcher/hacker_term

    ターミナルからHacker Newsが見れるGem
    ramtiga
    ramtiga 2013/01/05
  • GitHub直伝 プルリクエスト活用の3つのコツ

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

    GitHub直伝 プルリクエスト活用の3つのコツ
  • 1