Wie finde ich die geeignete Person für die API-Überprüfung?

Question

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

Dies ist bereits implementiert und dokumentiert.

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

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

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

Answer 1

Es wäre am besten, einen Programmierer zu finden, der bereits ein bekanntes Framework für die betreffende Sprache entwickelt hat.

WHat Ihre Benutzer denken, ist irelevent Ich denke, weil Sie über Framework nicht beurteilen können, indem Sie willkürliche Programmierer seine thoughts darüber fragen. Seine Antwort wird von seinem Kenntnisstand und seinen persönlichen Methoden abhängen, während API für eine breitere Bevölkerung entwickelt wird (ich gehe davon aus, dass dies dein Fall ist). Um diesen Punkt zu beenden, denke ich in meinen Programmierern, die VB.NET benutzen, dass C# eine lahme Sprache ist, weil man in C# Button = "Text" nicht schreiben kann und der Compiler automatisch die Standardeigenschaft für dich findet. Sie wollen nicht, dass diese Person Ihren Rahmen beurteilt.

Sogar Designer, die in verschiedenen Sprachen erfahren sind, können hilfreich sein, da breitere verwendete APIs mit Hilfe bekannter Programmiermuster implementiert werden sollten, mit denen die Leute bereits vertraut sind.

Answer 2

Suchen Sie jemanden, der nicht mit Ihrem Produkt vertraut ist, um einen Beispielcode oder eine Referenzimplementierung eines Clients für Ihre API zu erstellen. Dann erfahren sie, wo die Dokumentation mangelhaft ist oder ob die API verbessert werden muss. Dies kann ein Auftragnehmer oder ein neuer Entwickler sein (ein guter Weg, um sie auf den neuesten Stand zu bringen).

Answer 3

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

diese Regeln Nach einer großen Anzahl von Usability-Problemen mit Ihrer Schnittstelle zu vermeiden, bevor eine Überprüfung ist notwendig.

Zweitens, führen Sie eine Usability-Studie mit ein paar Zielentwicklern, diejenigen, die wahrscheinlich diese API nutzen, aber noch nie zuvor gesehen haben. Stellen Sie sie vor das System und geben Sie ihnen ein paar Aufgaben, dann beobachten Sie, wie sie herausfinden, wie es geht. Ihre Schmerzpunkte werden Ihnen sagen, wo Sie Verbesserungen vornehmen müssen.

Answer 4

Fragen Sie Ihre Endbenutzer und finden Sie heraus, welche Ihre API verwenden, um mit Ihrer Software zu interagieren. Anschließend können Sie diese Nutzer befragen und ihre Meinungen zu den verschiedenen Funktionen, die Sie in Ihrer API anbieten, zusammen mit der Benutzerfreundlichkeit und Übersichtlichkeit Ihrer Dokumentation erhalten.

Answer 5

Jede API hat eine bestimmte Zielgruppe (z. B. Kunden, die Integrationen zu Ihrem Produkt entwickeln). Unter diesem Gesichtspunkt wäre es am besten, das Feedback von Mitgliedern dieses Publikums zu erhalten. Sie können z. B. ein frühes Zugriffsprogramm einrichten oder einige öffentliche Betas versenden.

Wenn Sie keine solche Zielgruppe haben (dh Sie entwickeln eine API für ein Produkt, das noch nicht öffentlich ist), würde ich vorschlagen, einige der Usability-Tests zu machen - dh wählen Sie einen Entwickler mit ungefähr Zielgruppe Fähigkeiten und Geben Sie ihm eine Aufgabe, die die API-Nutzung betrifft. Dann bekomm ein Feedback von ihm.

Answer 6

Wenn ich in Ihren Schuhen wäre, würde ich beginnen, Beispielanwendungen zu schreiben und entweder eine Präsentation zu machen, um Leute durch die Schritte oder eine andere ähnliche Übung zu führen. Es ist nicht so gut wie Feedback von Benutzern, aber es kann einige Probleme ausschütteln.

Eine andere (möglicherweise schlechte) Idee ist, Geld für die Ela- nce/Guru-Seiten auszugeben und eine Beispielanwendung/Funktionalität zu finden, die Ihrer Meinung nach repräsentativ dafür ist, wie die Benutzer die API nutzen werden. Machen Sie das Projekt dafür und erhalten Sie dann auch Feedback von den Entwicklern als Teil des Projekts.

Sie werden wahrscheinlich wollen Menschen, die in Ihrer Muttersprache kommunizieren können ...

By the way, zu warten, bis alles dokumentiert und umgesetzt wird, sind wahrscheinlich nicht die beste Zeit, es zu überprüfen ... es wäre waren viel besser, die Überprüfung vor der Implementierung zu tun.