배포 통과 기준

Crates.io에 크레이트 배포하기

배포는 코드 완성만이 아니라 메타데이터, 문서 주석, 버전 의미가 함께 공개되는 절차라는 점을 확인합니다.

1

한 번 공개

같은 버전은 되돌려 다시 올릴 수 없으므로 배포 전 패키지를 검산합니다.

manifest

필수 메타데이터

description, license, 저장소 정보가 사용자의 선택 단서가 됩니다.

docs

문서 주석

공개 API는 /// 설명과 예제가 함께 있어야 문서 페이지에서 바로 읽힙니다.

semver

버전 약속

호환성을 깨는 변경은 새 버전 숫자로 드러내야 의존하는 프로젝트가 판단할 수 있습니다.

crates.io 배포 점검

  • cargo package로 포함 파일과 빌드 가능성을 먼저 확인합니다.
  • 토큰은 cargo login에만 쓰고 소스 저장소에 남기지 않습니다.

사용자 관점

  • README와 문서 주석이 같은 사용 방법을 말하는지 맞춥니다.
  • 키워드와 카테고리는 검색 가능성을 높이는 실제 단서로 고릅니다.