Revisiones entre repositorios

La revisión entre repositorios es lo que hacen posible los Sistemas. Agrupa repositorios relacionados en un sistema y una revisión podrá comprobar cómo afecta un cambio al código de cada repositorio que ese sistema alcanza.

Agrupa repositorios relacionados en un sistema y registra sus conexiones para que las revisiones puedan seguir esas relaciones. Esta guía te muestra cómo configurarlo. Para una introducción a las partes, las conexiones y los resultados de descubrimiento, consulta Sistemas.

Antes de empezar

Los repositorios están conectados, en la nube o en tu propia instancia.
Eres propietario o administrador del espacio de trabajo, o es el tuyo personal. Sin eso, los botones a continuación no se muestran en absoluto.

1. Lee cada repositorio

Un repositorio no entra en un sistema como una parte sin más. Al leerlo se deriva un sistema propio, llamado owner/repo, y el sistema mayor se compone entonces de esos sistemas más pequeños.

Abrir Sistemas en la barra lateral. Si no se ha modelado nada verás Nada modelado todavía y un botón Crear un sistema ; de lo contrario, usa el botón + en el encabezado, que tiene la información emergente Nuevo sistema.

El panel se titula Dibujar un sistema. Cerca de la parte inferior, bajo Aún no leído, cada repositorio conectado sin un sistema detrás se lista con un botón Leerlo Lee los que quieras en el sistema.

También puedes hacerlo desde la página del propio repositorio, donde el botón es Inicializar desde GitHub, o Leer de nuevo si ya se ha leído antes.

2. Crea el sistema que los contiene

En el mismo panel:

Lee los repositorios, bajo Lo que parece un sistema, propone agrupaciones. Cada sugerencia indica de dónde proviene: De una dependencia declarada, De importaciones entre repositorios, o Solo de nombres. No crea nada por sí misma.
Nombra el sistema, por ejemplo Billing.
Qué es: una línea sobre lo que debe entenderse en conjunto para cambiarlo.
Dentro de otro sistema: déjalo en Nada. Este es un sistema propio a menos que lo estés anidando.
Sistemas que contiene: marque los sistemas de repositorio que leyó en el paso 1. Pasan a formar parte de este sistema en lugar de ser sistemas propios.
Crear sistema.

Solo de nombres merece una lectura atenta. Una sugerencia basada únicamente en un nombre coincidente es la evidencia más débil que existe, y es la que más conviene comprobar a mano.

3. Encontrar las conexiones

Abra el sistema. Haga clic en el icono con forma de compartir justo a la izquierda del + botón en el encabezado. Su información emergente es Buscar conexiones: lea a qué están unidos, según lo que publica cada uno y lo que dice su código. Aparece una vez que el sistema contiene sistemas de repositorio.

Lee los repositorios en segundo plano e informa del progreso, por ejemplo Leyendo 3 repositorios. luego Se leyeron 3 repositorios. No se pudo leer 1. Cuando termina, la página pasa sola a la pestaña Partes . En un entorno grande puede tardar varios minutos; salir de la página no lo detiene.

4. Aprobar lo que es real

Todo lo que encuentra la inferencia llega como pendiente. Nada de lo que propone se trata como un hecho hasta que una persona lo confirma.

Tres lugares para revisarlas, todos con la misma función:

La tarjeta de triaje en la parte superior de la página Sistemas, titulada N conexiones por revisar y ordenada Primero la evidencia más débil. Aprobar o Rechazar cada una.
La Conexiones sección debajo de cada sistema en la Partes pestaña.
Arquitectura → Interactivo, que añade Mantener todos los N y Descartar todos para gestionar un montón con rapidez.

Empiece por la evidencia más débil, que es el orden en el que la tarjeta de triaje ya los presenta. Una conexión leída a partir de una dependencia declarada suele ser correcta. Una que se basa en una coincidencia de nombre merece los diez segundos que se tardan en abrir el archivo que cita.

Qué cambia realmente aprobar

Esta es la parte que merece la pena entender, porque no es lo que la mayoría supone. Una revisión cruza a otro repositorio independientemente de si el enlace está aprobado. La aprobación no condiciona el alcance. Cambia cómo se le permite hablar de él a la revisión.

Estado del enlace	Qué hace la revisión
Aprobado	Afirma el alcance como un hecho e indica dónde podría romper el otro lado el cambio.
Pendiente	Plantea como pregunta lo que el enlace significaría. No lo afirma y no le adjunta ninguna sugerencia.

Así que un grafo sin aprobar no es uno roto. Es uno más discreto. Aprobar es cómo le indica al revisor que se le permite ser categórico.

5. Leer una revisión

Abra una solicitud de incorporación de cambios en uno de los repositorios. La revisión gana una sección sobre a qué alcanza el cambio: los sistemas del otro extremo, el código hermano que fue a leer, citado con el repositorio y la revisión de la que proviene.

Un repositorio hermano se lee en la revisión en la que se indexó por última vez, porque una solicitud de incorporación de cambios fija solo la suya. Donde esa revisión es antigua, la revisión lo indica en lugar de presentarla como actual.

Lo que no pudo leer

Un repositorio al que la revisión no logró llegar se nombra en la revisión, con el motivo. No se omite de forma silenciosa.

Esa es la diferencia entre un revisor en el que puede confiar y uno en el que no. Un revisor que se salta en silencio la mitad de su sistema parece idéntico a uno que lo leyó todo y no encontró nada.

Las causas habituales, en orden de la frecuencia con la que resultan ser la respuesta:

El repositorio nunca se leyó, así que no tiene ningún sistema detrás. Vuelva al paso 1.
Está conectado, pero no dentro del mismo sistema.
La aplicación no está instalada en él, así que no hay nada que obtener.

Partes que no son repositorios

Gran parte de aquello de lo que depende un sistema no tiene código que leer. En la pestaña Partes, expanda un sistema y use + Añadir para añadir Un recurso: un Servicio, Base de datos, Cola, API externa, Implementación, Esquema, Documento, o algo más que usted mismo nombre.

Delé un Nombra y un Identificador, que es como se llama donde realmente reside, para que quien lea la revisión pueda ir y encontrarlo.

Vincular elementos manualmente

La inferencia solo propone aquello para lo que puede señalar un archivo. Cuando conozca una conexión que no puede ver, use Añadir conexiones en la pestaña Partes: elija Desde y Hacia, luego Cómo se vinculan. Las opciones son Depende de, Consume, Proporciona, Expone, Contiene, Despliega, Pruebas y Documentos.

Una conexión que usted mismo añade se aprueba de inmediato. Usted es la persona que la habría aprobado.

Revisión de código: contra qué más se evalúa un cambio.
Gestión del conocimiento: las decisiones y restricciones que una revisión lee junto con el grafo.
Revisiones de sistemas y entre repositorios: cómo se construye el mapa y se mantiene fiel a la realidad.