Las relaciones con desarrolladores son el trabajo de ayudar a desarrolladores externos a tener éxito con una plataforma, una biblioteca o una API, y de llevar lo que dicen a quienes la construyen. Combinan enseñanza, escritura, charlas, código de ejemplo y escucha. La credibilidad viene de ser un ingeniero en activo que respeta el tiempo de su público.
Conceptos clave
- Experiencia del desarrollador: todo el camino desde la primera mirada hasta un resultado que funciona; cada fricción es un usuario perdido.
- Tiempo hasta el primer éxito: qué tan rápido logra una persona nueva poner algo real en marcha.
- Contenido: tutoriales, ejemplos, charlas y videos, cada uno con una audiencia y un objetivo claros.
- Ciclo de retroalimentación: recoger preguntas e informes de errores, hallar patrones y conseguir que se arreglen.
- Comunidad: foros, eventos y mantenedores que responden, agradecen y dan la bienvenida.
Vocabulario
- Advocate: quien habla por los desarrolladores dentro de una empresa y por el producto fuera de ella.
- Aplicación de ejemplo: un programa pequeño que funciona y muestra la manera correcta de usar una API.
- SDK: kit de desarrollo de software, las bibliotecas y herramientas para construir sobre una plataforma.
- Onboarding: los primeros pasos de un desarrollador nuevo, del registro a una llamada que funciona.
Qué estudiar, en orden
- Sigue con un cronómetro la guía de inicio de otro proyecto y anota cada tropiezo.
- Construye una aplicación de ejemplo sobre una API pública y escribe su tutorial.
- Da una charla de diez minutos o graba un screencast sobre ella, y recoge las preguntas.
- Clasifica en temas las preguntas abiertas de un proyecto y propón tres arreglos.
- Aprende a escribir un informe de error honesto que un mantenedor pueda atender.
Etiquetas relacionadas
#technical-writing #api-design #open-source-community #documentation