기여하는 법
샘플은 CodeSampleX가 쓰고 검증한다. 그 주변은 전부 열려 있고, 정말로 다른 사람이 있어야 되는 부분이 가장 먼저 열려 있다.
CodeSampleX의 공식 샘플은 모두 독립적으로 생성되고 계약을 실행해 검증된다. 출처를 확인할 수 없는 샘플 코드는 받지 않는다.
누구나, 계정 없이
-
사용 증거
csx는 어떤 공개 패키지의 어떤 버전을 썼는지, 빌드나 테스트가 통과했는지, 실패했다면 정제된 실패 지문을 보고한다. 소스 코드·파일 경로·프로젝트 이름·비밀값·원본 로그는 머신을 떠나지 않는다. 로컬 전용 모드에서는 아무것도 나가지 않는다. 계정도 신원도 필요 없다.
-
내 머신에서의 검증
이건 프로젝트 혼자서는 못 하는 유일한 일이다. 샘플은 실재하는 머신 위에서 검증되고, 당신의 머신에는 여기서 아무리 일해도 대체할 수 없는 libc 버전과 런타임 빌드와 OS가 있다. 두 번째 머신이 같은 결과를 내야 샘플이 PUBLISHED에서 CROSS_PASS로 올라간다. 그 사다리는 남의 컴퓨터로 지어진다.
-
버그와 패치 노트
가장 값진 제보는 릴리스 노트다. 라이브러리가 뭔가를 고쳤는데 실제로 무엇이 바뀌었는지는 아무도 적어두지 않았다. 그게 regression case가 된다 — 구버전은 계약에 실패하고 신버전은 통과한다 — 그리고 그 쌍은 각각의 반쪽보다 값지다. 라이브러리와 버전, 그리고 본 것을 적어달라.
-
샘플 요청하기
폼은 없다. 요청이 이미 세어지고 있기 때문이다. NO_SAFE_MATCH로 끝난 검색은 전부 그 패키지에 대한 요청으로 기록된다. 즉 csx를 쓰고 답을 못 받은 것 자체가 요청이다. 그 목록은 공개돼 있고, 그게 이 프로젝트의 할 일 목록이다.
샘플 코드를 받지 않는 이유
샘플의 값어치는 그 출처의 값어치와 정확히 같다. 출처 불명의 코드는 아무도 추적할 수 없는 라이선스를 달고 오고, 누군가의 회사 것일 실질적 가능성을 안고 오며, 어디서 복사됐는지 확인할 방법이 없다. 그리고 틀린 답과 달리 그중 어느 것도 남의 에이전트가 읽고 난 뒤에는 되돌릴 수 없다. 이 프로젝트가 검색에 적용하는 규칙은 기여에도 그대로 적용된다 — 틀린 샘플이 없는 샘플보다 나쁘다.
나중에 열릴 수 있다. 열린다면 기부가 아니라 제안으로 열린다. 패키지, API, 사용 사례, 문서 링크만 받고 코드는 여전히 클린룸에서 생성해 여기서 검증한다.