Wie richtige Person für die API-Funktion Beitrag zu finden?

Question

Wir entwickeln ein Produkt, das eine API-Schnittstelle bietet, so dass andere Entwickler einige Funktionen von Hauptprodukt verwenden können.

Dies ist bereits umgesetzt und dokumentiert werden.

Aber ich bin nicht sicher, dass dies sehr nützlich ist, und die Dokumentation ist sehr klar für Entwickler.

Wie können wir Menschen finden, um diese Funktion zu überprüfen? Welche Art von Person sollte es sein?

In gewissem Sinne, wir suchen Product Owner für einzelne Funktion / Komponente. Ist es möglich?

Answer 1

Es wäre das Beste sein, einen Programmierer zu finden, die bereits einige bekannten Rahmen für die betreffende Sprache entwickelt hat.

Was ist Ihre Mitglieder halten ist irelevent Ich denke, weil Sie nicht über Rahmen, indem er beliebigen Programmierer seine toughts darüber urteilen kann. Seine Antwort hängt von seinem Wissensstand und persönlichen Methoden während API ist für eine breitere Bevölkerung ausgelegt ist (Ich gehe davon aus das ist dein Fall). Um diesen Punkt zu beenden, in meiner Firma Programmierer, die VB.NET denken verwenden, dass C # ist lahm Sprache becuase von ‚Probleme‘ wie man kann nicht Taste = „Text“ in C # schreiben und lassen Sie den Compiler automatisch Standardeigenschaft für Sie. Sie wollen nicht, diese Person Ihren Rahmen zu beurteilen.

Auch erfahrene Designer in verschiedenen Sprachen von Hilfe sein kann, weil breitere gebrauchte APIs sollten die Menschen bereits mit familar sind mit Hilfe von bekannten Programmiermuster umgesetzt werden.

Answer 2

Erhalten Sie jemanden, der mit Ihrem Produkt nicht erlebt hat einige Beispiel-Code oder eine Referenzimplementierung eines Clients für Ihre API zu machen. Dann werden sie ein gutes Gefühl dafür, wo die Dokumentation mangelhaft ist oder die API verbessert werden muss. Dies kann ein Unternehmer sein, oder ein neuer Entwickler (guter Weg, bis sie ihre Geschwindigkeit zu bekommen).

Answer 3

Erstens, wenn Sie eine API für die Verwendung durch andere entwickelst, würde ich empfehlen, ein Buch zu lesen wie: http://www.amazon.com/Framework-Design-Guidelines-Conventions-Development/dp/0321545613

diese Regeln folgend wird eine große Anzahl von Usability-Problemen mit Ihrer Schnittstelle vermeiden, bevor eine Überprüfung erforderlich ist.

Zweitens, eine Usability-Studie mit einem paar Ziel Entwicklern führen, diejenigen, die wahrscheinlich sind, Verwendung dieser API machen, haben aber noch nie zuvor gesehen. Setzen Sie sie vor dem System und geben ihnen ein paar Aufgaben, dann beobachten, wie sie etwa herauszufinden, gehen, wie es geht. Ihre Schmerzpunkte werden Ihnen sagen, wo Sie Verbesserungen vornehmen müssen.

Answer 4

Poll Endbenutzer und finden Sie heraus, welche Ihre API verwenden, um mit Ihrer Software zu interagieren. Sie können dann den Benutzer Umfrage und ihre Meinungen über die verschiedenen Funktionen erhalten Sie zusammen mit der Benutzerfreundlichkeit und Klarheit Ihrer Dokumentation in Ihrer API bieten.

Answer 5

Jede API hat einige Zielgruppe (das heißt Kunden Integrationen, um Ihr Produkt zu entwickeln). Aus dieser Sicht wäre es das Beste sein, das Feedback von den Mitgliedern dieser Zielgruppe zu erhalten. Sie können etablieren das heißt einige frühen Zugang Programm, oder einige öffentliche Betas versenden.

Wenn Sie kein solches Publikum haben (dh Sie entwickeln API für ein Produkt, das noch nicht öffentlich ist), würde ich vorschlagen, einige König von ‚Usability-Tests‘ zu tun - dh einen Entwickler holen von etwa Publikum Geschick Ziel und geben ihm einige Zuordnung Beteiligung der API-Nutzung. Dann lassen Sie sich Feedback von ihm.

Answer 6

Wenn ich an deiner Stelle wäre würde ich anfangen Beispielanwendungen zu schreiben und entweder eine Darstellung tut Menschen zu gehen, obwohl die Schritte oder eine andere ähnliche Übung. Es ist nicht so gut wie Feedback von Nutzern bekommen, aber es kann einige Probleme schütteln.

Eine andere (möglicherweise schlecht) Idee ist, Geld auf den elance / Guru-Sites zu verbringen und kommen mit einer Beispielanwendung / Funktionalität, die Sie denken, ist repräsentativ dafür, wie Benutzer gehen, um die API zu verwenden. Machen Sie das Projekt für das und dann auch Feedback von den Entwicklern als Teil des Projektes.

Sie werden wahrscheinlich wollen Menschen, die in Ihrer Muttersprache kommunizieren kann ...

übrigens warten, bis alles dokumentiert und umgesetzt werden ist wahrscheinlich nicht die beste Zeit, es zu überprüfen ... es wäre viel besser gewesen, die Überprüfung vor der Implementierung zu tun.