실험적

이 디렉터리에는 새로운 아이디어를 빠르게 반복할 수 있도록 최소한의, 명확하게 분리된 공간을 제공합니다.

안정성 계약: trl.experimental 아래에 있는 모든 항목은 사전 비추천(deprecation) 절차 없이 어떤 릴리스(패치 버전 포함)에서도 변경되거나 제거될 수 있습니다. 이러한 API를 프로덕션 워크로드에 의존하지 마세요.

프로모션 경로 (간단)

1. 메인 저장소 밖에서 프로토타입을 만듭니다: 빠른 반복을 위해 자신의 포크 또는 별도의 저장소에서 개발을 시작합니다.
2. 실험적 포함: 초기 사용자를 위한 준비가 완료되면 아이디어를 trl.experimental.<feature>로 이동하세요.
3. 개선: 테스트, 짧은 문서/예제 추가 및 사용 방법 시연.
4. Promote: API가 안정적이고 커뮤니티의 명확한 관심 또는 채택이 있을 경우, trl.<feature>(안정 모듈)로 이동합니다.

제거

Experimental은 스테이징 영역이지 장기 저장소가 아닙니다. 기능은 승격되거나 제거됩니다. 위에서 설명한 안정성 계약에 따라 제거에는 비추천(deprecation) 주기가 필요하지 않습니다. 코드는 git 히스토리에 남아 있으며, paper index 항목도 유지되어 해당 구현이 포함된 마지막 릴리스를 가리킵니다.

임계값에 의해 삭제가 트리거되지 않습니다. 이는 모든 사람이 수치를 확인할 수 있는 상태에서 삭제 pull request를 통해 내려지는 판단입니다. 해당 판단에서 고려되는 요소:

• 사용 방법. Telemetry, Hub 태그, 그리고 pull request 또는 discussion thread에 대한 답변입니다. 이 중 어느 하나만으로는 결론을 내릴 수 없으나, 모두 조용하다면 강력한 신호입니다.
• 기능을 실행하는 과정에서 발생하는 외부 이슈 및 pull request로, 코드 스캔을 통해 생성된 리포트와 구별됩니다.
• 안정적인 트레이너가 이미 해당 기능을 지원하는지 여부. 이미 지원한다면, 이는 사용 빈도보다 우선합니다.
• 비용. CI 시간, 유지보수, 트리아지 부하.
• 하류 소비자. 이를 가져오는 라이브러리.
• 소유자(Owner). 해당 항목의 승격을 원하고 필요한 작업을 수행할 의사가 있는 사람.
• 연령. 커뮤니티가 해당 모델을 발견하고 시도해 볼 수 있을 만큼 충분히 오랫동안 사용 가능했는지 여부.

자주 묻는 질문

왜 브랜치를 사용하지 않는가? 브랜치는 사용자에게 배포되지 않기 때문입니다. 패키지 내부의 실험적 코드는 초기 채택자들이 기능을 시험해 보고 피드백을 제공할 수 있게 합니다.

이러한 API는 예고 없이 변경되거나 사라질 수 있나요? 네. trl.experimental 내부의 모든 것은 어떤 릴리스에서도 변경되거나 사라질 수 있습니다.

프로덕션 환경에서 이 기능을 사용해야 하나요? 상황이 변할 때 코드를 빠르게 업데이트하는 데 문제가 없다면 사용하세요.

trl.experimental의 문제를 유지보수자가 신속하게 수정할까요? 반드시 그렇지는 않습니다. 실험적 모듈은 새로운 아이디어를 위한 실험 공간이며, 유지보수자는 해당 모듈의 버그 수정이나 기능 요청을 우선적으로 처리하지 않을 수 있습니다. 기능이 안정된 API로 승격될 때까지(또는 승격되지 않는 한) 문제가 해결되지 않을 수 있습니다.

논문 구현을 기여했습니다. 제거할 수 있나요? 네. trl.experimental 아래에 있는 모든 것, 논문 구현을 포함하여 제거될 수 있습니다. 그렇게 되면 논문 인덱스 항목은 유지되며 해당 코드가 포함된 마지막 릴리스를 가리킵니다.

런타임 알림을 비활성화하는 방법

사용: export TRL_EXPERIMENTAL_SILENCE=1.