Comment contribuer
Les échantillons sont écrits et vérifiés par CodeSampleX. Tout ce qui les entoure est ouvert, et la partie qui a réellement besoin d'autres personnes l'est en premier.
Chaque échantillon officiel de CodeSampleX est généré indépendamment et vérifié en exécutant son contrat. Le projet n'accepte pas de code d'échantillon dont il ne peut pas établir l'origine.
Ouvert à tous, sans compte
-
Preuves d'utilisation
csx rapporte quel paquet public et quelle version vous avez utilisés, si la compilation ou les tests sont passés, et une empreinte d'échec assainie quand ce n'est pas le cas. Le code source, les chemins de fichiers, les noms de projet, les secrets et les journaux bruts ne quittent jamais la machine — en mode local uniquement, rien n'en sort du tout. Ni compte ni identité.
-
Vérification sur votre machine
C'est la seule chose que le projet ne peut pas faire seul. Un échantillon est vérifié sur les machines qui existent, et la vôtre a une version de libc, une compilation d'exécution et un système que rien ici ne peut remplacer. Il faut qu'une deuxième machine soit d'accord pour qu'un échantillon passe de PUBLISHED à CROSS_PASS : cette échelle est bâtie avec les ordinateurs des autres.
-
Bugs et notes de version
Le signalement le plus précieux est une note de version : une bibliothèque a corrigé quelque chose et personne n'a écrit ce qui a réellement changé. Cela devient un cas de régression — l'ancienne version échoue au contrat, la nouvelle le passe — et la paire vaut plus que chaque moitié. Indiquez la bibliothèque, les versions et ce que vous avez observé.
-
Demander un échantillon
Il n'y a pas de formulaire, parce que la demande est déjà comptée. Chaque recherche qui se termine par NO_SAFE_MATCH est enregistrée comme une demande pour ce paquet : utiliser csx sans obtenir de réponse est en soi la demande. La liste est publique, et c'est la liste de tâches du projet.
Pourquoi le code d'échantillon n'est pas accepté
Un échantillon vaut exactement ce que vaut son origine. Du code de provenance inconnue apporte une licence que personne ne peut retracer, une possibilité bien réelle qu'il appartienne à l'employeur de quelqu'un, et aucun moyen de vérifier d'où il a été copié — et contrairement à une mauvaise réponse, rien de tout cela ne se reprend une fois que les agents des autres l'ont lu. La règle que ce projet applique à la recherche s'applique aussi à la contribution : un mauvais échantillon est pire qu'un échantillon absent.
Cela pourra s'ouvrir plus tard, et si c'est le cas, ce sera sous forme de proposition et non de don : le paquet, l'API, le cas d'usage et un lien vers la documentation — le code restant généré en salle blanche et vérifié ici.