 |
Resumen | Discourse Code Review permite revisar commits de GitHub en Discourse. |
 |
Enlace al repositorio | https://github.com/discourse/discourse-code-review |
 |
Guía de instalación | Cómo instalar plugins en Discourse |
Funciones
¿Qué es?
El plugin Discourse Code Review proporciona una integración bidireccional con repositorios de código de GitHub. Permite a tu equipo revisar commits en un repositorio aprovechando las funciones y plugins de Discourse, como asignación, susurros, notificaciones, flujos de trabajo personalizados, etc. Cada commit en un repositorio se convierte en un tema. Las respuestas al tema se reflejan en GitHub. La integración es bidireccional, lo que significa que puedes comentar en Discourse y verlo en GitHub, o comentar en GitHub y verlo en Discourse.
Proporciona un flujo de trabajo muy potente para equipos que necesitan revisar todos los commits en cualquier número de repositorios.
Te permite asegurarte de que varios miembros del equipo estén al tanto de todos los cambios aplicados a los repositorios. Puedes marcar commits para seguimiento, asignar trabajo de revisión y más.
Nota: Al ver un tema que puede aprobarse, puedes usar la tecla y en tu teclado para aprobar commits más rápido.
¿Puedo verlo en acción?
Discourse utiliza este plugin internamente para hacer un seguimiento de los repositorios. Puedes ver un ejemplo del lado de Discourse aquí:
En GitHub, el mismo tema se ve así:
Configuración
El plugin se basa en webhooks de GitHub para detectar repositorios y cambios en los repositorios. Para una configuración mínima, necesitarás establecer la siguiente configuración en una cadena secreta.
code review github webhook secret
Una vez establecido en tu repositorio de GitHub, configura un webhook con:
URL de carga: https://YOUR_DISCOURSE/code-review/webhook
Tipo de contenido: application/json
Secreto: el valor de code review github webhook secret
Tipos de eventos:
- Comentarios de commits
- Comentarios de issues
- Solicitudes de extracción (Pull requests)
- Revisiones de solicitudes de extracción
- Comentarios de revisiones de solicitudes de extracción
- Empujes (Pushes)
El plugin proporciona las siguientes configuraciones adicionales del sitio:
code review api username : GitHub es muy restrictivo con el número de solicitudes de API anónimas que permite. Esta configuración te permite usar las claves de cuenta de un usuario de Discourse para las solicitudes /comments y /commit. Esto reduce en gran medida la probabilidad de alcanzar los límites de tasa.
code review catch up commits : número de commits para “ponerse al día” y crear temas cuando se encuentra un nuevo repositorio.
code review default parent category: elige una categoría padre predeterminada para las categorías creadas por el plugin
code review pending tag: Etiqueta a aplicar a todos los commits sin revisar, pending por defecto
code review approved tag: Etiqueta a aplicar a los commits aprobados, approved por defecto
code_review_followup_tag: Etiqueta a aplicar a los commits de seguimiento, follow-up por defecto
code review allow self approval: ¿Se permite al personal aprobar sus propios commits?
code review default mute new categories: Las nuevas categorías creadas por code review están silenciadas para los usuarios por defecto
code review skip duration minutes: Hacer clic en el botón de omitir en un commit impedirá que ese commit vuelva a aparecer durante el número de minutos establecido por esta configuración.
CHANGELOG
TODO
Extras
Cómo Discourse usa este plugin
TL;DR - Este plugin fue diseñado para complementar el uso de GitHub por parte del equipo de Discourse para la revisión de código.
Más información
De @sam:
Seguimos usando PRs a través de la interfaz de GitHub y nos encanta hacer PRs para muchos cambios. Nada ha cambiado aquí. GitHub es fantástico, nos encanta GitHub. Tienen un excelente flujo de trabajo para los cambios que aún no se han incorporado. Sin embargo…
El flujo de trabajo de GitHub para los cambios que se han commitado directamente al repositorio es terrible.
Review cubre un vacío que simplemente no puede ser cubierto por GitHub hoy en día. Nos gustaría que al menos un miembro del equipo revisara cada cambio realizado en nuestros diversos repositorios git propiedad de Discourse. Si usamos la interfaz proporcionada por GitHub, nadie estaría nunca permitido para hacer nada más que solicitudes de extracción. Esto nos frenaría enormemente.
Necesitamos la capacidad de comunicarnos en privado sin que todo el mundo lo sepa con respecto a ciertos cambios. Por ejemplo: Mejor desplegar esta increíble corrección a
<insert giant company name>lo antes posible, ¿puedes encargarte de ello, @sam?Necesitamos la capacidad de aprobar cambios realizados o solicitar seguimiento, algo que la interfaz de GitHub no ofrece.
Necesitamos la capacidad de asignar commits particulares a un usuario. Digamos que @sam hace un commit que contiene algunos errores. Es bueno que podamos asignarle directamente ese commit particular, marcarlo para seguimiento y luego hacer un seguimiento de que se ha seguido.
Discourse es bastante fantástico en todo lo relacionado con la conversación, y las pequeñas funciones hacen una diferencia bastante grande. Puedo ver cuando la gente está escribiendo. Nunca necesito actualizar las páginas para que aparezcan los cambios. Citar es muy bueno, las cargas de imágenes son buenas, y así sucesivamente.
Discourse es muy bueno en el estado de lectura, obtienes garantías muy fuertes de que has leído cada cosa una vez. Con GitHub, no tengo idea de qué commits leí y cuáles no. Tenemos una eficiencia increíble para lidiar con la corriente de información.
Y la lista continúa…
Así que review actúa como un complemento para GitHub, usamos GitHub en este momento para lidiar con los cambios que aún no se han incorporado. Y usamos review para manejar adecuadamente los cambios que ya se han incorporado.