Le nuove API (Application Programming Interface) annunciate durante la conferenza F8, che dovevano semplificare tanto la vita agli sviluppatori, sono arrivate già da un pò e anzichè semplificarla hanno incasintato ancora di più la vita al programmatore. Già perchè sebbene alcune idee siano molto buone (interfaccia REST, protocollo oAuth 2.0) la documentazione e gli esempi sono completamente errati e sbagliati, privi di coerenza e nella fattispecie inutilizzabili. E' una vergogna che il sito con più iscrizioni al mondo si presenti così male dal punto di vista professionale. L'unico modo per imparare le nuove API è quello di cercare in giro per internet su blog o articoli vari e procedere a TASTONI!
Probabilmente le nuove funzionalità sono state rilasciate in fretta e furia, senza controllare che ciò che rende una libreria o una API utilizzabile: la documentiazione. Facebook gioca con la pazienza e con la vita dei programmatori (si perchè ovviamente si deve perdere tempo per cercare di capire come funzionano queste API che definirle uscite dal sedere di una vacca è un gran complimento).
Cosa andrebbe fatto:
- Stilare una VERA guida che indichi cosa si può fare oggi e cosa è sconsigliato
- Completare la documentazione
- Scrivere esempi funzionanti
- Infine riorganizzare la documentazione (com'erano le vecchie api andava benissimo!)
Nessun commento:
Posta un commento