공개 배포 절차

크레이트 배포는 문서, 공개 경로, 메타데이터, 버전 관리의 합이다

사용자가 크레이트를 발견하고, 문서 예제를 실행하고, 안정적인 버전에 의존할 수 있도록 배포 전후의 책임을 순서대로 확인한다.

1

문서화 주석 작성

`///`와 `//!`로 공개 함수와 크레이트 목적을 설명하고 예제를 남긴다.

2

문서 테스트 실행

`cargo test`가 문서 예제를 실행해 실제 사용 코드가 깨졌는지 찾는다.

3

`pub use`로 공개 API 정리

내부 모듈 구조와 사용자가 가져올 경로를 분리해 첫 화면에서 찾게 한다.

4

필수 메타데이터 입력

고유한 이름, 설명, 라이선스, 버전을 `Cargo.toml`에 명확히 적는다.

5

배포 뒤 버전 처리

`cargo publish` 후 잘못된 버전은 삭제가 아니라 `cargo yank`로 막는다.