피처 플래그 뒤에 배포된 문서 기능

GitLab에서 피처 플래그 뒤에 배포된 기능을 문서화하는 방법과 히스토리 텍스트 및 플래그 노트 추가 절차를 설명합니다.

GitLab은 자체 기능의 배포를 단계적으로 진행하기 위해 피처 플래그 를 사용합니다. Note 피처 플래그의 상태를 변경한 개발자가 문서를 갱신할 책임이 있습니다. 피처 플래그 뒤의 기능을 문서화할 시점 # 어떤 환경(GitLab Self-Managed, GitLab.com, GitLab Dedicated)에서 모든 고객을 대상으로 피처 플래그가 활성화되기 전에 해당 기능을 문서화해야 합니다. 플래그 뒤에 있는 그 밖의 모든 기능은 해당 그룹의 PM 또는 EM 이 문서화 여부를 결정합니다. 기능과 함께 플래그를 문서화하지 않더라도, 플래그는 중앙 페이지에 자동으로 문서화됩니다 . 피처 플래그 문서 추가 방법 # 피처 플래그를 문서화하는 방법은 다음과 같습니다. 히스토리 텍스트를 추가합니다 . 플래그 노트를 추가합니다 . Offerings # offerings 를 문서화할 때, GitLab Self-Managed에서 비활성화된 기능에는 해당 기능의 offering으로 GitLab Dedicated 를 적지 않습니다. 히스토리 텍스트 추가 # 플래그의 상태가 바뀌면(예: 기본 비활성화에서 기본 활성화로) 그 변경 사항을 히스토리 에 추가합니다. 히스토리 항목으로 사용할 수 있는 예시는 다음과 같습니다. - [ Introduced ]( https://issue-link ) in GitLab X.X [ with a feature flag ]( ../../administration/feature_flags/_index.md ) named `flag_name`. Disabled by default. - [ Enabled on GitLab.com ]( https://issue-link ) in GitLab X.X. - [ Enabled on GitLab Self-Managed and GitLab Dedicated ]( https://issue-link ) in GitLab X.X. - [ Enabled on GitLab.com, GitLab Self-Managed, and GitLab Dedicated ]( https://issue-link ) in GitLab X.X. - [ Generally available ]( https://issue-link ) in GitLab X.Y. Feature flag `flag_name` removed. 이 항목이 모든 상황에 맞지는 않습니다. 필요에 맞게 조정할 수 있습니다. 예를 들어 플래그가 특정 그룹, 프로젝트, 또는 일부 사용자에게만 활성화될 수 있습니다. 그런 경우에는 다음과 같은 히스토리 항목을 사용할 수 있습니다. - [Enabled on GitLab.com](https://issue-link) in GitLab X.X for a subset of users. 피처 플래그 변경 사항 추가 # 여러 피처 플래그가 통합되거나 이후 릴리스에서 피처 플래그 이름이 변경되면, 그 변경 사항을 히스토리 항목에 언급합니다. - [ Introduced ]( https://issue-link ) in GitLab