Header Ads Widget

Ticker

6/recent/ticker-posts

5 errores frecuentes de la comunidad de desarrolladores (y cómo solucionarlos)


Hemos estado en el juego de las API por un tiempo y hemos visto cómo se cultiva una parte justa de comunidades de desarrolladores convincentes Por otro lado, también hemos visto algunos fallos épicos. En nuestra Cumbre de Plataformas 2016, Shayne Parmelee , líder de experiencia en desarrollo en Shopify, habló sobre algunos de sus propios éxitos (y fracasos) durante su tiempo en la empresa.

Y eso nos hizo pensar. Queríamos ver si podíamos encontrar 5 de los errores más comunes que cometen los desarrolladores de API cuando intentan crear una comunidad de desarrolladores y / o mejorar la DX (experiencia de desarrollador) de su producto.

También hemos intentado encontrar algunas soluciones, varias de las cuales se inspiraron en Shayne.

Esta publicación se inspiró en una charla impartida por Shayne Parmelee en la Cumbre de la Plataforma Nórdica de APIs 2016:

Error n. ° 1: 1–1 El apoyo no es realista

Existe un problema inherente al desarrollo y lanzamiento de las API: los usuarios seguramente se encontrarán con problemas , incluso si proporciona documentación completa y fácil de entender. Esa es simplemente la naturaleza del desarrollo de software.

El problema aquí es que, con toda probabilidad, no tienes suficientes desarrolladores en tu equipo para que funcionen como agentes de soporte. Desafortunadamente, en algunos casos, la creación de una API es un proyecto que los desarrolladores emprenderán y luego pasarán tan pronto como esté terminado. Cualquier agente de soporte asignado para lidiar con las secuelas, si es que hay alguno, puede que no esté familiarizado con los matices de la API.

Solución: enviar soporte a la comunidad

"Cuando se ayuda a los desarrolladores, hay mucha información incompleta, falta de contexto, falta de comunicación ... por lo que es realmente difícil ayudar a una persona a la vez".

Tome Shopify como ejemplo: el equipo de cinco de Shayne fue responsable de mantener 80 terminales , una tonelada de bibliotecas y media docena de SDK ... lo que equivale a la asombrosa cantidad de 20 millones de acciones de API cada hora.

Como dice en su charla, “ser útil se siente realmente bien” pero no es escalable para atender todas las consultas que llegan por correo electrónico. Mientras trabajaba en Shopify, puso más énfasis en referir a los consumidores de API a sus foros .

Sin embargo, esta no es la solución milagrosa que muchos desarrolladores de API podrían estar esperando. Shayne menciona que, en un momento de su mandato, más de la mitad de las publicaciones en los foros quedaron sin respuesta. Sin embargo, en última instancia, Shopify vio mejoras del soporte liderado por la comunidad y explicaremos cómo llegaron allí a continuación.

Lea también: Acumulación de comentarios: 4 preguntas que los proveedores de API deben hacer a sus usuarios

Error # 2: si lo construyes, vendrán

Imagínese crear una API impresionante, repleta de funciones útiles y luego no hacer absolutamente nada para promoverla. Como hemos escrito anteriormente , ahí es exactamente donde algunos proveedores de API se quedan cortos, pero esperamos que la mayoría de ustedes se den cuenta de que se hace un gran esfuerzo en la evangelización , el descubrimiento de API y otras estrategias para atraer usuarios.

Lo mismo ocurre con la construcción de una comunidad de desarrolladores: para citar a Shayne nuevamente, " solo porque tienes una comunidad de desarrolladores no significa que la gente realmente va a participar ". Es realmente un escenario del huevo y la gallina; Las comunidades de desarrolladores son más útiles cuando ya cuentan con subprocesos sobre diferentes problemas y cuestiones que cubren las posibles soluciones utilizadas por otros consumidores de API; esto es lo que hace que StackOverflow sea tan poderoso.

Solución # 2: Sea el primero en publicar

En lugar de depender de una comunidad que se formara de la nada, el equipo de Shopify comenzó liderando la discusión. Después de que ellos mismos participaron en sus foros, notaron las siguientes mejoras:

  • Aumento de actividad del 48%
  • +1165 desarrolladores de nuevas aplicaciones
  • Aumento del 45% en la resolución de problemas con un solo toque
  • Disminución del 10% en el número total de consultas de soporte

Esa última estadística es enorme, porque demuestra que nutrir a una comunidad de desarrolladores puede tener y tiene un impacto no solo en la actividad, sino que ofrece verdaderas ganancias cuando se analizan las cosas desde una perspectiva de costo versus valor.

Construir una comunidad solo funciona si tienes una presencia constante allí. Los foros de Overwatch , donde el vicepresidente de Blizzard, Jeff Kaplan, aparece regularmente para responder preguntas y recopilar comentarios, son un gran ejemplo de esto.

¿Qué se necesita para convertirse en un evangelista de API? Aprende aquí

Error n. ° 3: la gamificación comunitaria es fácil

Hagamos una rápida muestra de manos: ¿cuántas de las personas que leen esto siguen jugando Pokémon Go ? Si eres como nosotros, probablemente descargaste la aplicación, jugaste durante unos días y te rindiste cuando llegó "la próxima gran novedad".

Hay un cierto valor de novedad asociado con la gamificación : Pokemon Go fue uno de los primeros en combinar esto con AR y llevarlo a la corriente principal, pero la novedad pronto se desvanece sin otras ventajas que la respalden. Emitir insignias o estatus de "Élite" a los usuarios avanzados suena como una buena idea en teoría, pero no agrega sostenibilidad por sí solo.

Solución # 3: Agregue valor a través del karma

En el caso de esta prueba de Shopify, agregar votos positivos ofreció una ventaja inesperada: los votos positivos demostraron ser útiles para identificar las características y problemas más "en demanda".

Sin embargo, lo que no hizo fue generar un aumento significativo en la participación de los usuarios . ¡De vuelta a la mesa de dibujo! Agregar beneficios por la participación, como acceso con descuento a productos o botines, es una forma de incentivar la participación, pero probablemente no funcionará por sí sola a menos que la comunidad ya esté creciendo orgánicamente.

¿No estás seguro de qué ofrecer a los usuarios que contribuyen mucho? ¡Podrías tomar una hoja del libro de StackExchange yendo realmente a meta y preguntando a tu comunidad qué tipo de botín comunitario quieren! Ah, y asegúrate de conseguir camisetas que te queden ...

Error # 4: No involucrarse lo suficientemente temprano

Independientemente del tamaño de una empresa u organización, algunas personas tienden a dejarse llevar por sus ideas y la construcción antes de haber tenido en cuenta las necesidades de los usuarios. En esa situación, la mentalidad se ve así:

  • Construir
  • Lanzamiento
  • Retocar

El problema principal aquí es que los desarrolladores que trabajan así no ven ningún comentario hasta la etapa de prueba beta o durante un lanzamiento suave, momento en el que puede ser demasiado tarde para abordar preocupaciones serias. Como veremos a continuación, Shopify pudo expandir esa mentalidad de una manera que preservó esa sensibilidad iterativa mientras mejoraba los productos incluso antes de que fueran construidos, y mucho menos lanzados.

Cualquier desarrollador de API sabe que es mucho más difícil modificar una API o un producto en vivo que iterar mientras aún está en desarrollo. Esto se debe a que, tan pronto como una API se activa, cualquier tiempo de inactividad corre el riesgo de interrumpir todos los servicios que dependen de ella.

Solución n. ° 4: problemas previos al vaciado antes del lanzamiento

Shayne habla sobre su pequeño equipo que empaqueta los próximos diseños de tal manera que les permitió mostrar las características a los consumidores de API antes de que fueran lanzadas oficialmente, expandiendo así la mentalidad anterior para crear un nuevo proceso de desarrollo:

  • Idea : Genere documentos de diseño tecnológico iniciales.
  • Piense : agregue contexto a esos documentos, hágalos más digeribles, explique la motivación, elabore NDA.
  • Explorar : envíe a un pequeño subconjunto de desarrolladores para recibir comentarios.

ENTONCES

  • Construir
  • Lanzamiento
  • Retocar

¿Parecer familiar? Lo anterior tiene mucho en común con la metodología Lean Start , solo que con un poco más de énfasis en incluir a los usuarios al principio del proceso.

Tomado de TheLeanStartup.comTheLeanStartup com

Al interactuar con sus usuarios desde el principio , ya sea en una comunidad de desarrollo establecida o en un subconjunto de consumidores de API seleccionados al azar, puede obtener sus comentarios antes de pasar semanas o meses creando algo con características que nadie realmente necesita.

Error n. ° 5: su documentación es inadecuada

Hemos escrito en otro lugar sobre el proceso Y la importancia de crear documentación eficaz , pero ese proceso implica más que simplemente escribir contenido útil. Debe considerar cosas como las siguientes:

  • ¿Cuál, si alguna, de su documentación está indexada públicamente por Google?
  • ¿Su documentación está disponible para cualquiera o solo para aquellos que usan su API?
  • ¿Proporciona ejemplos de cómo funciona su API in situ?

Ignorar preguntas como estas es casi tan malo como escribir documentación de mala calidad o incompleta, porque todavía está poniendo el mismo esfuerzo que alguien que mantiene y distribuye su documentación de manera efectiva pero no verá las mismas recompensas.

Solución # 5: Darle cuerpo y agregar contexto, etc.

Puede resumir la posición de Shayne sobre la documentación en la siguiente oración:

"Si las cosas no son fáciles de encontrar, es mejor que no estén allí".

Utiliza el ejemplo de una página que está vinculada desde una página específica en GitHub que recibe 2.5 veces más tráfico que una página similar indexada públicamente. Ese es un buen recordatorio de que los consumidores de API quieren poder seguir una serie de pasos lógicos y no tener que saltar a Google, buscar "cómo implementar la API xyz" y rastrear página tras página de resultados.

API Marketing 101: aprenda a hacer que su API sea más visible

Pensamientos finales

Crear y cultivar una comunidad de desarrolladores comprometida no es una tarea fácil. Pero ofrece una serie de enormes beneficios para usted y su API:

  • Apoyo liderado por la comunidad (y opciones fáciles para futuros estudios de casos);
  • Comentarios previos al lanzamiento de los usuarios existentes;
  • Personas que están dando sus primeros pasos para convertirse en evangelizadores externos de su API.

Solo recuerde hacer todo lo posible para eludir los anti-patrones descritos anteriormente y estará en camino de crear una herramienta increíblemente valiosa para tener en su caja de herramientas API.

 

Publicar un comentario

0 Comentarios