실험 및 베타 기능 문서화
어떤 기능들은 일반적으로 사용할 수 없고 실험 또는 베타로 간주됩니다.
이러한 세 가지 상태 중 하나로 기능을 문서화하는 경우:
- 페이지 또는 주제 제목 뒤에 등급 배지를 추가합니다.
- 좌측 탐색에
(실험)
또는(베타)
를 포함시키지 않습니다. - 변화 이력에서 해당 기능의 상태를 확인합니다.
이러한 기능들은 일반적으로 피처 플래그 뒤에 숨겨져 있으며, 이 문서 지침을 따릅니다.
사용자가 등록하는 방법이나 문제가 있는 경우 팀에 연락하는 방법의 세부 정보를 추가하는 경우 FLAG:
노트를 이러한 세부 정보 위에 추가해야 합니다.
예를 들어:
## 멋진 새로운 기능
DETAILS:
**상태:** 실험
> - [GitLab 15.10](link)에서 도입되었습니다. 이 기능은 [실험](<link_to>/policy/experiment-beta-support.md)입니다.
FLAG:
Self-managed GitLab에서 이 기능은 기본적으로 사용할 수 없습니다.
이를 사용할 수 있게 하려면 관리자가 `example_flag`라는 피처 플래그를 활성화할 수 있습니다.
GitLab.com 및 전용 GitLab에서는 이 기능을 사용할 수 없습니다. 이 기능은 프로덕션 환경에 사용할 준비가 되지 않았습니다.
이 새로운 기능은 다음을 수행해야 할 때 사용하세요.
이 기능은 [실험](<link_to>/policy/experiment-beta-support.md)입니다. 이 기능을 테스트하는 사용자 디렉터리에 추가하려면 이 작업을 수행하세요.
버그를 발견하면 [이슈를 엽니다](link).
해당 기능이 프로덕션 준비가 되면 제거하세요:
- 괄호 안의 텍스트.
- 해당 기능이 프로덕션 환경에 사용할 준비가 되지 않았다는 어떤 언어도 제거하세요.
- 사용 가능한 경우 해당 피처 플래그 정보를 제거하세요.
프로덕션 준비가 된 경우 변화 이력을 최신 상태로 유지하기 위해 프로덕션 릴리스에 대한 노트를 추가하세요.