2009-04-14 6 views
0

私たちはAPIインターフェイスを提供する製品を開発しているので、他の開発者は主要製品の機能を使用することができます。API機能のレビューに適切な人物を見つけるにはどうすればよいですか?

これは既に実装され、文書化されています。

しかし、これは非常に便利であるとは確信できません。ドキュメントは開発者にとって非常に明確です。

この機能をどのように見直すことができますか? どのような人にすべきですか?

一部の意味では、単一の機能/コンポーネントの商品所有者を探しています。出来ますか?

答えて

1

問題の言語の既知のフレームワークを既に設計しているプログラマーを見つけることが最善の方法です。

あなたのユーザーはireleventだと思うものは、任意のプログラマーにそのことについて尋ねることによってフレームワークについて判断することはできないと思います。彼の答えは、知識と個人的な方法論のレベルに依存しますが、APIはより広範な人口(私はこれがあなたのケースであると仮定しています)用に設計されています。この点を終わらせるためには、VB.NETを使っている私の会社のプログラマーでは、C#でButton = "Text"と書くことができず、コンパイラがデフォルトプロパティを自動的に見つけられるように、C#が "問題"あなたはそのような人があなたの枠組みを判断することを望まない。

言語の異なるデザイナーでさえも、広く使用されているAPIは、すでによく知られているよく知られたプログラミングパターンの助けを借りて実装する必要があります。

1

あなたの製品に慣れていない人に、サンプルコードやAPIのクライアントの参照実装を作成してもらう。そうすれば、ドキュメンテーションが不足している場所やAPIを改善する必要がある場所を知ることができます。これは請負業者、または新しい開発者(速度を上げるための良い方法)です。あなたが他の人が使用するためのAPIを開発している場合

1

まず、私のような本を読んでお勧めします。これらのルールに従いhttp://www.amazon.com/Framework-Design-Guidelines-Conventions-Development/dp/0321545613

任意のレビューがある前に、あなたのインターフェイスを備えたユーザビリティの問題の多数を避けることができます必要。

第2に、このAPIを使用する可能性が高いが以前には見たことのない、数人のターゲット開発者とのユーザビリティスタディを実行します。それらをシステムの前に置き、いくつかのタスクを与えてから、どのようにしてそれを行うかを調べる方法を見てください。彼らの痛みポイントは、改善が必要な場所を教えてくれるでしょう。

+0

本のためのヒューゲット感謝。非常に便利です! :) – ep3static

1

あなたのエンドユーザーをポーリングして、どのAPIがあなたのソフトウェアとやりとりするためにAPIを使用しているかを調べます。これらのユーザーを調査して、APIで提供されているさまざまな機能と、ドキュメントの使いやすさと明快さに関する意見を得ることができます。

1

すべてのAPIにはターゲットオーディエンスがいくつかあります(つまり、お客様の製品に統合されているクライアント)。この観点から、このオーディエンスのメンバーからのフィードバックを得ることが最善の方法です。つまり、早期アクセスプログラムを確立するか、パブリックベータを出荷することができます。

このような視聴者がいない(つまり、まだ公開されていない製品のAPIを開発している)場合は、「ユーザビリティテスト」のいくつかの王をすることをお勧めします。 API使用に関するいくつかの課題を教えてください。その後、彼からのフィードバックを得る。

1

私はあなたの靴の中にいた場合、サンプルアプリケーションを作成し、手順や他の同様の練習をしながら人々を歩くためのプレゼンテーションを開始するでしょう。ユーザーからのフィードバックを得るほど良くはありませんが、いくつかの問題を揺るがす可能性があります。

別の(おそらく悪い)アイデアは、elance/guruサイトにお金を費やして、ユーザーがAPIをどのように使用するかを代表すると思われるサンプルアプリケーション/機能を考え出すことです。プロジェクトを作成し、プロジェクトの一環として開発者からのフィードバックも得てください。

あなたはおそらく、あなたの母国語でコミュニケーションできる人をお勧めします...ところで

、それはすべて文書化され、実施されるまで待って、おそらくそれを確認するための最良の時間ではありません...それはです実装前にレビューを行う方がはるかに優れています。

関連する問題