Cómo contribuir
Las muestras las escribe y verifica CodeSampleX. Todo lo que las rodea está abierto, y la parte que de verdad necesita a otras personas lo está antes que nada.
Cada muestra oficial de CodeSampleX se genera de forma independiente y se verifica ejecutando su contrato. El proyecto no acepta código de muestra cuyo origen no pueda establecer.
Abierto a cualquiera, sin cuenta
-
Evidencia de uso
csx informa qué paquete público y qué versión usaste, si la compilación o las pruebas pasaron, y una huella de fallo saneada cuando no. El código fuente, las rutas de archivos, los nombres de proyecto, los secretos y los registros en bruto nunca salen de la máquina; en modo solo local no sale nada en absoluto. Sin cuenta y sin identidad.
-
Verificación en tu máquina
Es lo único que el proyecto no puede hacer solo. Una muestra se verifica en las máquinas que existen, y la tuya tiene una versión de libc, una compilación del runtime y un sistema operativo que ningún trabajo aquí puede sustituir. Que una segunda máquina coincida es lo que lleva una muestra de PUBLISHED a CROSS_PASS: esa escalera está hecha con los ordenadores de otros.
-
Errores y notas de parche
El informe más valioso es una nota de versión: una biblioteca arregló algo y nadie escribió qué cambió en realidad. Eso se convierte en un caso de regresión —la versión antigua falla el contrato, la nueva lo pasa— y el par vale más que cualquiera de las mitades. Indica la biblioteca, las versiones y qué observaste.
-
Pedir una muestra
No hay formulario, porque la petición ya se está contando. Cada búsqueda que termina en NO_SAFE_MATCH queda registrada como una petición para ese paquete: usar csx y no obtener respuesta es, en sí mismo, la petición. La lista es pública y es la lista de tareas del proyecto.
Por qué no se acepta código de muestra
Una muestra vale exactamente lo que vale su origen. El código de procedencia desconocida trae una licencia que nadie puede rastrear, una posibilidad muy real de que pertenezca al empleador de alguien, y ninguna forma de comprobar de dónde se copió; y a diferencia de una respuesta equivocada, nada de eso se puede retirar una vez que los agentes de otros lo han leído. La regla que este proyecto aplica a la búsqueda se aplica también a la contribución: una muestra equivocada es peor que una muestra ausente.
Puede abrirse más adelante, y si lo hace será como propuesta y no como donación: el paquete, la API, el caso de uso y un enlace a la documentación, con el código todavía generado en sala limpia y verificado aquí.