Revisar las nuevas entradas enviadas a un catálogo de recursos técnicos

## Usar un solo archivo del catálogo como base y generar desde él el sitio y los datos Trata un único documento de catálogo legible por personas como fuente de verdad. Genera índices, conjuntos de datos estructurados y páginas estáticas desde esa fuente en lugar de editar por separado los artefactos derivados. Organiza las entradas por categorías temáticas, no por encabezados de lenguaje de implementación. Guarda la compatibilidad con lenguajes mediante etiquetas en línea para que un recurso pueda declarar varios lenguajes sin cambiar de categoría temática. Documenta el flujo de datos: 1. El documento del catálogo almacena las entradas seleccionadas. 2. Un analizador valida las entradas, amplía los metadatos externos aprobados y escribe un conjunto de datos estructurado. 3. Un generador del sitio lee el conjunto de datos cuando está disponible; en caso contrario, analiza directamente el catálogo para las vistas previas locales. 4. La integración continua ejecuta el analizador y el generador y después publica únicamente el directorio generado del sitio. Mantén el comportamiento del analizador, el generador y el despliegue conforme a este contrato. No conviertas una página o un conjunto de datos generado en otra fuente de verdad que compita con la principal. ## Escribir cada entrada del catálogo con un mismo formato y etiquetas de lenguaje Define una sola estructura de entrada reconocible por el analizador y trata la puntuación como parte del contrato. Una entrada habitual contiene un nombre enlazado, una o más etiquetas de lenguaje en línea y una descripción: ``- [Name](https://example.org) - `Language` - Description.`` Aplica estas reglas: - las nuevas entradas no comerciales deben contener al menos una etiqueta de lenguaje seguida del separador obligatorio; - las descripciones deben terminar con un punto antes de cualquier enlace opcional al repositorio de origen; - los enlaces nuevos deben usar `https://`; - los recursos comerciales o propietarios deben estar en una categoría específica; - las etiquetas de lenguaje solo pueden omitirse en categorías comerciales o explícitamente ajenas a lenguajes; - la guía de contribución dirigida a los usuarios sigue siendo la fuente autorizada para quienes presentan entradas. Acepta varias etiquetas de lenguaje sin cambiar la estructura circundante. Permite un enlace opcional al repositorio después de la descripción completa. Mantén válidos los enlaces a paquetes propios de un ecosistema cuando sigan la misma gramática de entrada. No flexibilices el patrón del analizador por una sola entrada mal formada. ## Revisar con rigor las entradas nuevas y avisar de las antiguas solo como advertencias Usa el entorno y los envoltorios de tareas documentados en el repositorio para validar, analizar y publicar. Respeta la versión de ejecución exigida e instala las dependencias mediante el comando canónico. Usa dos modos de validación: 1. La validación de cambios comprueba únicamente las entradas añadidas con respecto a la revisión base elegida. 2. La validación del catálogo completo comprueba todas las entradas. En las entradas nuevas, trata como errores los duplicados, los enlaces mal formados y las infracciones de la política de URL. En el catálogo completo, informa de los problemas heredados equivalentes como advertencias, salvo que se seleccionen explícitamente opciones estrictas. No permitas que la deuda heredada tolerada reduzca el criterio de admisión de entradas nuevas. Ejecuta el analizador únicamente cuando estén disponibles las credenciales necesarias. Permite que el generador del sitio use un conjunto de datos estructurado existente o la alternativa documentada de análisis directo para las vistas previas locales. ## Revisar solo las entradas que indiques y buscar duplicados Limita la revisión a las entradas que haya indicado el usuario. Para operar con solicitudes de incorporación, usa el conector configurado del repositorio, no un cliente de línea de comandos ajeno. Antes de cualquier acción que modifique datos: 1. Examina los archivos propuestos y sus diferencias. 2. Comprueba la categoría y el formato exacto de la entrada. 3. Busca duplicados en el catálogo que actúa como fuente de verdad. 4. Verifica que las URL tengan un formato seguro. 5. Evalúa con pruebas la actividad actual del proyecto y su documentación. 6. Presenta los hallazgos antes de modificar el estado externo. No revises otras entradas solo porque estén abiertas. No deduzcas la popularidad ni el estado de mantenimiento únicamente a partir de la descripción presentada. Distingue el cumplimiento del formato del catálogo de la calidad y utilidad continuada del recurso. ## Preguntar antes de comentar o fusionar una solicitud de incorporación Pregunta siempre al usuario antes de comentar, etiquetar, cerrar o fusionar una solicitud de incorporación. Aplica la etiqueta de revisión completada solo después de que el usuario apruebe el comentario de revisión. Fusiona únicamente tras recibir aprobación explícita para esa fusión. Usa las herramientas conectadas del repositorio para enumerar solicitudes abiertas; inspeccionar detalles, archivos, comentarios, etiquetas y diferencias; obtener el catálogo de la rama predeterminada para buscar duplicados; y realizar cambios aprobados. Nunca sustituyas el conector necesario por otra herramienta externa cuando no esté disponible. Si falta el conector, informa de que las operaciones del repositorio están bloqueadas y pide al usuario que lo configure. Separa la recopilación de pruebas de solo lectura de las modificaciones externas. Una instrucción de revisión no autoriza por sí misma comentarios, etiquetas, cierres ni fusiones. ## Mantener en secreto la clave de acceso y publicar el sitio solo con el proceso automático Trata el enriquecimiento de metadatos externos como una operación que requiere credenciales. No lo ejecutes sin la credencial de acceso necesaria y nunca expongas esa credencial en comandos, informes, páginas generadas ni archivos confirmados. Mantén reproducible la publicación: - analiza el catálogo canónico y conviértelo en el conjunto de datos estructurado documentado; - permite que las vistas previas locales usen solo la alternativa documentada; - genera la página estática a partir de la entrada actual validada; - publica únicamente mediante el flujo configurado de integración continua; - revisa los cambios generados cuando cambie el comportamiento del analizador o la plantilla. No afirmes que la publicación tuvo éxito basándote solo en una vista previa local. Verifica por separado el artefacto generado y el flujo de publicación. ## Informar qué se revisó, separando los errores nuevos de las advertencias antiguas Informa de las entradas revisadas, los hallazgos, el modo de validación y cualquier operación bloqueada. Indica si las comprobaciones cubrieron únicamente las entradas nuevas o el catálogo completo. Separa las advertencias originadas por contenido heredado de los errores introducidos por el cambio actual. Antes de terminar, confirma: - el catálogo siguió siendo la fuente de verdad; - se comprobaron la gramática, la puntuación, las etiquetas, las categorías y las URL seguras; - se buscaron duplicados con respecto a la rama predeterminada actual; - las afirmaciones sobre actividad y documentación se basaron en pruebas; - no se modificó ningún estado externo sin aprobación; - los artefactos generados no se confundieron con el contenido fuente autorizado. Mantén el informe lo bastante conciso para facilitar una decisión, pero incluye todos los hallazgos capaces de cambiar la admisión.