Administrar los comentarios en proyectos grandes de código abierto como Flutter
En Google, siempre nos alegra ver el modo en que Flutter crece como un proyecto comunitario de código abierto. Ya sea en términos de popularidad en GitHub, cantidad de proyectos creados o aumento de las habilidades, el 2019 fue un año muy importante para el proyecto y queremos expresarte nuestra eterna gratitud por la ayuda y los aportes que hicieron de Flutter el proyecto que hoy es. Creamos Flutter contigo y para ti, y esperamos que eso se manifieste en todo lo que hacemos.
A medida que crecemos, también aumenta la cantidad de problemas que debemos controlar. Los problemas en GitHub no solo sirven para notificar errores, sino también para hacer referencia a cualquier unidad de trabajo del proyecto. Todas las personas pueden notificar errores y estos se clasifican en las siguientes categorías:
- Solicitudes de funciones, que hacen referencia a aspectos que Flutter podría incorporar o mejorar.
- Problemas de asistencia, es decir, preguntas de los usuarios sobre el funcionamiento de Flutter o lo que pueden hacer en el proyecto. Aunque es mejor formular estas preguntas en Stack Overflow, muchas mencionan también aspectos de nuestra documentación que podríamos mejorar.
- Defectos legítimos, en otras palabras, elementos que no funcionan como deberían. Esto abarca problemas graves (como fallas y regresiones de rendimiento) y también esos pequeños errores molestos que suelen ocurrir en sistemas de software importantes.
- Elementos no evaluados que no se analizaron ni etiquetaron.
Con esto queda demostrado que nuestros problemas no son solo una recopilación de defectos, sino que constituyen trabajo acumulado. Todo aspecto en el que deseemos trabajar debe representarse como un problema y etiquetarse correctamente. De este modo, tendremos un punto de partida para planificar nuestras metas y objetivos.
Algunos proyectos usan la cantidad de errores sin resolver como un parámetro para medir la calidad de las versiones y clasifican los errores como defectos o problemas. Flutter no funciona así. Lo que hacemos es controlar los errores y problemas en el mismo lugar (GitHub) y no mantenemos nada en secreto. En consecuencia, siempre serán más las tareas de las que podríamos ocuparnos que aquellas de las que nos ocupamos. Esto sucede con muchos proyectos de código abierto que funcionan bien; basta con echar un vistazo a los que están hace tiempo, como Tensorflow, Chrome, Dart, Go o VSCode.
Sin embargo, queremos asegurarnos de que los problemas que recibimos estén bien etiquetados y llevar adelante las tareas necesarias para que la base de datos de problemas refleje correctamente el estado de nuestro producto. A tal fin, nos involucramos con la comunidad y convocamos a un grupo de voluntarios que nos ayudan durante la evaluación inicial. Además, nos complace anunciar que nos asociamos con Nevercode, que son los proveedores de Codemagic (un sistema de IC/EC líder para Flutter) para que también nos ayuden con las evaluaciones iniciales.
El ciclo de vida de un problema
Siempre estamos dispuestos a recibir notificaciones sobre errores. En las Pautas de evaluación, describimos el proceso que usamos para evaluar errores. Así es como funciona en la práctica:
Un problema empieza contigo (usuario de Flutter) o con un colaborador del proyecto de código abierto. Una vez que lo notificas (lo mejor es que los errores incluyan casos reproducibles o las solicitudes de funciones detallen claramente qué propones y por qué), se envía a la etapa de evaluación inicial.
Durante esta etapa, un participante de la comunidad, como un voluntario, alguien de Nevercode o un ingeniero de Flutter, analiza el problema y formula varias preguntas:
- ¿Está claramente definido?
- Si es un error, ¿incluye un caso reproducible e información suficiente para continuar?
- Si es una mejora de una función, ¿entendemos bien qué pide el usuario para poder evaluar si constituye un aporte para la plataforma?
- ¿Ya se notificó este problema en el pasado?
A medida que hacemos esto, aplicamos la mayor cantidad posible de etiquetas al problema durante la evaluación inicial. Usamos las etiquetas de muchas formas, por ejemplo, para establecer la prioridad relativa, determinar cómo dirigir un problema a un equipo específico y decidir si hace falta incluir el problema en un objetivo futuro. Usamos las consultas de GitHub y algunas herramientas personalizadas para analizar los problemas en busca de elementos que indiquen qué busca la comunidad y por qué.
Luego, tiene lugar la evaluación secundaria, durante la cual un equipo asignado analiza el problema y formula preguntas, por ejemplo, cómo se adapta el problema al trabajo que realiza el equipo actualmente y cuándo pueden programar la finalización del trabajo. Nuevamente, se agregan o cambian etiquetas, ya que nos permiten obtener la mejor perspectiva sobre el trabajo que queremos hacer y quién puede hacerlo.
Con el tiempo, un ingeniero se ofrece a trabajar en el problema. A diferencia de muchos proyectos de software, no solemos asignar los problemas a colaboradores. En cambio, son los colaboradores (de Google o externos) quienes se ofrecen a abordar los problemas en lugar de que se los asignen a partir del trabajo acumulado. Al permitir que sean los desarrolladores quienes se ofrezcan, dejamos el equilibrio de carga en manos de ellos. Cada colaborador se asigna a sí mismo solamente los problemas en los que esté trabajando activamente y define objetivos para que podamos saber cuándo llegarán a la rama principal. Los líderes pueden pedir a una persona específica que se ocupe de un problema si así lo desean, pero, en definitiva, es solo eso: un pedido de ayuda, no un ultimátum ni una asignación.
Después de que estamos satisfechos con la resolución del problema, lo cerramos. Solemos incluir un vínculo a la solicitud de incorporación de cambios en la que se aborda el problema, pero también se cierran problemas por otros motivos, como los siguientes:
- ¿Se trata de una solicitud de asistencia? Si es así, dirigimos a la persona que envió la notificación a un canal de asistencia, como la lista de distribución de flutter-dev@googlegroups.com, el sitio de Reddit r/FlutterDev, nuestras comunidades de Discord (el chat de usuarios o el chat de la comunidad que usan principalmente los colaboradores) o Stack Overflow.
- ¿Ya se notificó antes este problema? Antes de cerrarlo, incluimos un vínculo al problema original y lo actualizamos.
- ¿Hay suficiente información para reproducir el problema y pudimos hacerlo? Si no es así, es muy probable que no podamos hacer nada y cerraremos el problema.
Nuestros avances hasta el momento
Como puedes imaginarlo, el aumento de nuestra popularidad trae aparejado más problemas abiertos y cerrados en github.com/flutter/flutter (donde se almacenan todos los problemas, salvo los del sitio web, que se registran en github.com/flutter/website):
También es notoria la cantidad de problemas que no tienen una etiqueta de uno de nuestros equipos de evaluación secundaria, como marco de trabajo, motor o complemento.
Se ve claramente cuándo empezamos a involucrar a Nevercode en el proceso de evaluación (a inicios de septiembre) y cómo se lograron avances importantes para mediados de septiembre cuando Nevercode se puso al corriente.
El énfasis en la evaluación es fiel reflejo de nuestra meta: en lugar de eliminar los errores abiertos, buscamos eliminar los errores sin etiquetar para que nuestra comunidad nos brinde los indicadores que necesitamos para priorizar mejor el trabajo. A medida que Flutter aumenta su popularidad, esperamos que siga creciendo el número de problemas abiertos que requieren evaluación, muchos de los cuales constituirán solicitudes de funciones nuevas enviadas por la comunidad. Seguiremos usando etiquetas como ayuda para determinar qué errores requieren atención inmediata, cuáles pueden esperar hasta nuestra próxima versión beta o estable, y cuáles son solicitudes de funciones nuevas.
¿Cómo puedes ayudarnos?
Una forma de ayudarnos es mantener organizada la base de datos de problemas solo con problemas que se puedan abordar. Cuando notifiques un problema, ten presente lo siguiente:
- No uses GitHub si necesitas asistencia. Como parte del proceso de evaluación de problemas, cerraremos las solicitudes de asistencia publicadas en GitHub y redirigiremos a los usuarios a canales más adecuados. Es más probable que allí encuentres a alguien que pueda responder tu pregunta y es más fácil para otros usuarios encontrar preguntas y respuestas en estos canales.
- Recuerda incluir casos reproducibles, especialmente si el problema es tuyo. Si no es tuyo, igual aceptamos casos reproducibles que puedas notificar. Escribir casos reproducibles de errores es una excelente forma de empezar a aprender a usar Flutter con ejemplos reales.
- Actualiza problemas que te resulten importantes o súmate a ellos.
- Aporta casos de prueba al repositorio de Flutter. Esta es otra forma de introducirte al mundo de Flutter y formar parte de la comunidad. También ayuda a evitar las regresiones; aunque todo el código nuevo viene acompañado de casos de prueba, intentamos aumentar la cobertura de las pruebas como práctica recomendada. Si te interesa colaborar de este modo, puedes echar un vistazo a los problemas con la etiqueta a: tests.
- Considera ayudarnos a evaluar problemas que notifican otras personas.
Te agradecemos enormemente la ayuda y la confianza que depositas en nosotros al dedicar tu tiempo a Flutter y aportar tus ideas sobre aplicaciones. Nos encanta que la comunidad participe, ya sea notificando un error o una función que te gustaría ver, o creando una solicitud de incorporación de cambios para que Flutter sea la plataforma en la que quieres trabajar. ¡Gracias!
Source: Google Dev