Come trovare persona più appropriata per la revisione funzione API?

Question

sviluppando un prodotto che fornisce un'interfaccia API, in modo che altri sviluppatori possono utilizzare alcune funzionalità del prodotto principale.

Questa è già predisposta e documentata.

Ma non sono sicuro che questo è molto utile, e la documentazione è molto chiaro per gli sviluppatori.

Come possiamo trovare le persone a rivedere questa funzione? Che tipo di persona dovrebbe essere?

In un certo senso, stiamo cercando Product Owner per la singola funzione / componente. E 'possibile?

Answer 1

Si sarebbe la migliore per trovare un programmatore che ha già disegnato un quadro di riferimento noto per la lingua in questione.

ciò che gli utenti pensano sia irelevent penso, becuase non si può giudicare su quadro, chiedendo programmatore arbitraria suoi toughts su di esso. La sua risposta dipenderà il suo livello di conoscenze e metodologie personali durante API è stato progettato per una più ampia popolazione (sto assumendo questo è il tuo caso). Per finire questo punto, nei miei programmatori aziendali che utilizzano VB.NET pensare che C # è un linguaggio zoppo becuase di 'problemi' come te non può scrivere Pulsante = "testo" in C # e lasciare che il compilatore trovare automaticamente proprietà predefinita per voi. Se non si desidera tale persona a giudicare il vostro quadro.

Anche i progettisti con esperienza in diverse lingue può essere di aiuto perché API utilizzate più ampi dovrebbero essere attuate con l'ausilio di noti modelli di programmazione persone sono già familiarità con.

Answer 2

Come qualcuno che non è vissuto con il prodotto per fare qualche esempio di codice o di un'implementazione di riferimento di un cliente per la vostra API. Poi si otterrà un buon senso in cui la documentazione è carente o l'API deve essere migliorata. Questo può essere un imprenditore, o un nuovo sviluppatore (buon modo per farli fino a velocità).

Answer 3

In primo luogo, se si sta sviluppando un'API per l'utilizzo da parte di altri, vi consiglio la lettura di un libro come: http://www.amazon.com/Framework-Design-Guidelines-Conventions-Development/dp/0321545613

A seguito di tali norme sarà evitare un gran numero di problemi di usabilità con l'interfaccia prima di qualsiasi commento è necessario.

In secondo luogo, eseguire uno studio di usabilità con alcuni sviluppatori di destinazione, coloro che sono suscettibili di fare uso di questa API, ma non hanno mai visto prima. Mettetele in davanti al sistema e dare loro alcuni compiti, poi guardare come vanno circa capire come farlo. I loro punti di dolore vi dirà dove è necessario apportare miglioramenti.

Answer 4

Sondaggi gli utenti finali e scoprire quelli che stanno usando la vostra API per interagire con il software. È quindi possibile rilevare gli utenti e ottenere le loro opinioni sulle varie caratteristiche che offrite nella vostra API insieme con la facilità d'uso e la chiarezza della documentazione.

Answer 5

Ogni API ha un certo target di riferimento (vale a dire i clienti sviluppare integrazioni al prodotto). Da questo punto di vista, sarebbe la migliore per ottenere il feedback da membri di questo pubblico. È possibile stabilire cioè qualche programma di accesso anticipato, o spedire alcune versioni beta pubbliche.

Se non avete tale pubblico (per esempio, si sta sviluppando API per un prodotto, che non è ancora pubblico), vorrei suggerire di fare un po re di 'test di usabilità' - vale a dire scegliere uno sviluppatore di circa target di riferimento di abilità e dare lui qualche incarico che coinvolgono l'uso di API. Quindi ottenere un feedback da lui.

Answer 6

Se fossi nei tuoi panni vorrei iniziare a scrivere applicazioni di esempio e sia facendo una presentazione a camminare le persone anche se i passi o qualche altro esercizio simile. Non è buono come ottenere un feedback da parte degli utenti, ma può scuotere alcuni problemi.

Un altro (possibilmente cattiva) idea è quella di spendere soldi per i siti / guru Elance e venire con un'applicazione di esempio / funzionalità pensate è rappresentativo di come gli utenti stanno per utilizzare l'API. Rendere il progetto per questo e quindi anche ottenere un feedback dagli sviluppatori come parte del progetto.

Probabilmente desidera che le persone che possono comunicare nella vostra lingua madre ...

Tra l'altro, in attesa fino a quando non è tutto documentato e implementato non è probabilmente il momento migliore per fare una recensione ... sarebbe stato molto meglio per fare la revisione prima della loro attuazione.