Empieza por el proyecto, no por un nombre conocido
Puede que encuentres dos repositorios con nombres de proyecto parecidos mientras revisas un anuncio de lanzamiento público. Anota el sitio web del proyecto en el que ya confías, la URL de la organización que has encontrado y la URL del repositorio que estás revisando. Así evitas que una insignia de organización quede asociada en tus notas a un resultado de búsqueda que no tiene relación.
Abre el perfil de la organización en sí. Una insignia capturada en una captura de pantalla o mencionada en un README no es la misma observación que el perfil actual. Anota la fecha en que lo comprobaste y el dominio exacto que aparece junto a la información del perfil.
Lee con precisión la relación con el dominio
GitHub documenta su insignia de organización como resultado de verificar la propiedad de dominios. La información de sitio web y correo electrónico que muestra el perfil debe coincidir con dominios verificados; los distintos dominios, incluidas ciertas variantes, requieren su propia verificación. GitHub también describe la aprobación de dominios como un procedimiento aparte. Fuente
Compara el host exacto en lugar de dar por hecho que toda dirección que contenga el nombre del proyecto es equivalente. Para un proyecto ilustrativo, docs.example.org y example.org deben anotarse como hosts distintos aunque la organización gestione ambos. No deduzcas el estado de uno a partir de la ortografía del otro.
Esta es una tarea de lectura. No necesitas cambiar el DNS, solicitar acceso a la organización ni verificar un dominio tú mismo para inspeccionar la fuente pública de un proyecto.
Mantén tres comprobaciones distintas en filas separadas
| Objeto | Pregunta útil | Qué queda por comprobar |
|---|---|---|
| Perfil de la organización | ¿Qué relación con el dominio está documentada? | Si es la organización relevante para tu tarea |
| Repositorio | ¿Es este el proyecto enlazado por el propio sitio de la organización? | Si abriste el repositorio y la versión correctos |
| Versión o documento | ¿Qué dice el pasaje real? | Si respalda la afirmación concreta que piensas citar |
Un perfil puede ayudarte a navegar hasta un proyecto sin resolver la veracidad de cada afirmación de ese proyecto. Del mismo modo, la ausencia de insignia es una observación sobre el perfil, no una conclusión de que la organización sea fraudulenta.
Conserva la evidencia que realmente usaste
Sigue un enlace del proyecto desde el propio sitio web de la organización cuando esté disponible, compara su destino con el repositorio que encontraste y guarda la dirección de la versión o del documento relevante. Si el sitio y el repositorio no coinciden, conserva ambos destinos y etiqueta la relación como no resuelta en lugar de elegir la página más cuidada.
Para una comprobación ilustrativa de un changelog, el resultado útil es un repositorio, una versión de lanzamiento y la frase que respalda la función. Una insignia por sí sola no es ese resultado. Usa un enlace estable a la fuente de GitHub cuando el archivo pueda cambiar más adelante.
Si la insignia que viste está junto a un commit, usa en su lugar la guía sobre la firma de commits. Trata un objeto distinto y no debe sustituir la revisión del dominio de la organización.