제품 가용성 세부 정보는 기능에 대한 정보를 제공합니다.

• 세부 정보가 페이지 전체에 적용되면 페이지 맨 위, 단 front matter 다음에 배치합니다.
• 특정 섹션에 적용되면 해당 섹션 제목 아래에 배치합니다.

가용성 세부 정보에는 티어, 애드온(해당하는 경우), 오퍼링, 상태, 히스토리가 포함됩니다.

가용성 세부 정보의 Markdown은 다음과 같은 형태여야 합니다.

title: 'Topic title'
---



- Tier: Free, Premium, Ultimate
- Add-on: GitLab Duo Enterprise
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
- Status: Experiment





- [Introduced](https://link-to-issue) in GitLab 16.3.
- Updated in GitLab 16.4.

사용 가능한 옵션#

티어, 애드온, 오퍼링, 상태, 버전 히스토리에는 다음 텍스트를 사용합니다.

티어#

티어는 다음 중 하나를 선택합니다.

• Free, Premium, Ultimate
• Premium, Ultimate
• Ultimate

Free 티어에서 사용할 수 있는 GitLab Agent Platform 기능은 GitLab Credits 페이지로 링크합니다.

• [Free](../subscriptions/gitlab_credits.md#for-the-free-tier), Premium, Ultimate

애드온#

애드온 정보는 GitLab Duo와 GitLab Duo Self-Hosted의 기능에만 사용합니다.

GitLab Duo Agent Platform의 기능에는 애드온 정보를 사용하지 않습니다.

애드온으로 사용할 수 있는 값은 다음과 같습니다.

- Add-on: GitLab Duo Core, Pro, or Enterprise
- Add-on: GitLab Duo Pro or Enterprise
- Add-on: GitLab Duo Enterprise
- Add-on: GitLab Duo with Amazon Q

오퍼링#

오퍼링은 다음 항목을 이 순서대로 쉼표로 구분해 조합합니다.

• GitLab.com
• GitLab Self-Managed
• GitLab Dedicated
• GitLab Dedicated for Government

예시는 다음과 같습니다.

• GitLab.com
• GitLab.com, GitLab Self-Managed
• GitLab Self-Managed
• GitLab Self-Managed, GitLab Dedicated
• GitLab Dedicated, GitLab Dedicated for Government

상태#

상태는 다음 중 하나를 선택합니다.

• Beta
• Experiment
• Limited availability

일반 공급 기능에는 상태를 넣지 않습니다.

셀프 호스티드 모델을 사용하는 GitLab Duo#

셀프 호스티드 모델로 사용할 수 있는 GitLab Duo 기능에는 다음을 사용합니다.

- Available on [GitLab Duo with self-hosted models](<relative_link_to_gitlab_duo_self_hosted_documentation>)

해당 기능이 셀프 호스티드 모델을 사용하는 GitLab Duo에서 제공되지 않는다는 서술은 피합니다. 기능을 사용할 수 없다고 명시해야 한다면 Not available on GitLab Duo with self-hosted models를 사용합니다. 문서 링크는 넣지 않습니다.

LLM#

GitLab Duo 기능이 사용하는 LLM을 문서화해야 한다면 다음을 따릅니다.

• 해당 LLM 링크를 포함합니다.
• 기능이 다음에 서로 다른 LLM을 사용한다면 항목을 분리합니다.
  • 코드 생성과 코드 완성.
  • GitLab Duo with Amazon Q.

예시는 다음과 같습니다.

- LLMs for code completion: Anthropic [Claude 4.0 Sonnet](https://console.cloud.google.com/vertex-ai/publishers/anthropic/model-garden/claude-sonnet-4)
- LLMs for code generation: Anthropic [Claude 3.7 Sonnet](https://console.cloud.google.com/vertex-ai/publishers/anthropic/model-garden/claude-3-7-sonnet)
- LLM for Amazon Q: Amazon Q Developer

히스토리#

문서 사이트는 버전 히스토리를 렌더링하는 데 Hugo 쇼트코드를 사용합니다. 예시는 다음과 같습니다.

- [Introduced](https://issue-link) in GitLab 16.3.
- [Changed](https://issue-link) in GitLab 16.4.

추가로 다음을 지킵니다.

• 히스토리 노트가 세부 정보(있는 경우) 뒤, 제목 바로 아래에 오도록 합니다.
• 출력이 제대로 생성되는지 확인합니다.
• 버전 히스토리가 -로 시작하는지 확인합니다.
• 가능하면 관련 이슈 링크를 포함합니다. 관련 이슈가 없으면 머지 리퀘스트나 에픽으로 링크합니다.
• 기밀 이슈로 링크하지 않습니다.
• 가격 페이지로 링크하지 않습니다.
• 티어가 다른 티어로 바뀌는 경우가 아니면 구독 티어를 넣지 않습니다.
• 여러 페이지에 항목을 중복해 넣지 않습니다. 변경된 기능을 문서화한 페이지에 항목을 추가합니다.

업데이트된 기능#

변경되거나 업데이트된 기능은 새 목록 항목을 추가합니다. 문장은 기능 이름이나 동명사로 시작합니다.

예시는 다음과 같습니다.

- [Introduced](https://issue-link) in GitLab 13.1.
- Creating an issue from an issue board [introduced](https://issue-link) in GitLab 14.1.

또는 다음과 같습니다.

- [Introduced](https://issue-link) in GitLab 13.1.
- Notifications for expiring tokens [introduced](https://issue-link) in GitLab 14.3.

구독 티어 이동#

다른 구독 티어로 이동하는 기능에는 moved를 사용합니다.

- [Moved](https://issue-link) from GitLab Ultimate to GitLab Premium in 11.8.
- [Moved](https://issue-link) from GitLab Premium to GitLab Free in 12.0.

청구 방식 변경#

좌석 기반 청구에서 GitLab Credits를 사용하는 사용량 기반 청구로 바뀌는 기능에는 changed to usage-based billing을 사용합니다.

- [Changed](https://issue-link) to usage-based billing in GitLab 19.0.

이 항목은 해당 기능의 히스토리에만 추가합니다. 기능이 크레딧을 사용하기 시작해도 크레딧의 동작 자체는 바뀌지 않으므로 GitLab Credits 히스토리에는 항목을 추가하지 않습니다.

기능 상태 변경#

기능 상태가 experiment에서 beta로 바뀌면 changed를 사용합니다.

- [Introduced](https://issue-link) as an [experiment](../../policy/development_stages_support.md) in GitLab 15.7.
- [Changed](https://issue-link) from experiment to beta in GitLab 16.0.

기능 상태가 beta에서 limited availability로 바뀌면 changed를 사용합니다.

- [Changed](https://issue-link) from experiment to beta in GitLab 16.0.
- [Changed](https://issue-link) from beta to limited availability in GitLab 16.3.

일반 공급으로 바뀌는 경우에는 다음을 사용합니다.

- [Generally available](https://issue-link) in GitLab 16.10.

프로그램의 일환으로 제공되는 기능#

프로그램의 일환으로 사용자에게 제공되는 기능은 새 목록 항목을 추가하고 해당 프로그램으로 링크합니다.

- [Introduced](https://issue-link) in GitLab 15.1.
- Merged results pipelines [added](https://issue-link) to the [Registration Features Program](https://page-link) in GitLab 16.7.

기능 플래그 뒤에 있는 기능#

기능 플래그 뒤에서 도입된 기능은 기능 플래그에 대한 세부 정보를 추가합니다. 자세한 내용은 기능 플래그로 배포된 기능 문서화를 참고합니다.

별도로 릴리스되는 도구의 기능#

일부 GitLab 도구는 GitLab 인스턴스와 무관하게 자체 일정으로 릴리스되고 다른 버전 체계를 사용합니다. 편집기 확장과 CLI 도구가 그 예입니다.

도구 업데이트는 히스토리 섹션에 포함합니다. 각 항목에는 GitLab 버전과 도구 버전을 모두 넣고, 해당 버전의 도구 릴리스 페이지 링크를 포함합니다.

기능에 GitLab 인스턴스 변경과 도구 업데이트가 모두 필요하면, 관련 인스턴스 히스토리 항목 아래에 도구 버전 항목을 중첩합니다.

- Access to user default namespaces for IDEs [introduced](https://issue-link) in GitLab 18.10.
  - [Introduced](https://release-page-link) in GitLab for VS Code 6.71.7.
  - [Introduced](https://release-page-link) in GitLab Duo CLI 8.76.0.

기능이 GitLab 인스턴스 변경에 의존하지 않으면 도구 버전으로 항목 하나만 추가하고, 인스턴스 요구 사항을 암시하지 않도록 in GitLab X.Y 대신 during the GitLab X.Y release를 사용합니다.

- [Introduced](https://release-page-link) in GitLab for VS Code 6.14.0 during the GitLab 18.1 release.

변경되거나 업데이트된 모델#

기본 모델을 포함해 GitLab Duo 기능에서 사용할 수 있는 모델은 AI Gateway에 정의되어 있습니다. 대부분의 경우 모델 변경은 모든 GitLab 버전에 즉시 반영되며 GitLab 릴리스에 묶이지 않습니다.

히스토리 항목에는 마일스톤 대신 날짜를 사용합니다. 문서 머지 리퀘스트가 아니라 변경을 수행한 AI Gateway 머지 리퀘스트로 링크합니다.

- Claude Sonnet 5 [added](https://ai-gateway-mr-link) as a supported model for Code Review Flow on August 3, 2026.

버전 제거#

지원되지 않는 버전을 언급하는 히스토리 항목과 인라인 텍스트는 제거합니다. 히스토리 항목을 제거할 때는 그 아래에 중첩된 도구 버전 항목도 함께 제거합니다.

GitLab은 현재 메이저 버전과 이전 메이저 버전 2개를 지원합니다. 예를 들어 18.0이 현재 메이저 버전이라면 GitLab 18.0, 17.0, 16.0의 모든 메이저 및 마이너 릴리스가 지원됩니다.

현재 지원되는 버전 목록은 버전 지원을 참고합니다.

기능 플래그 뒤에 있는 기능에 대한 정보는 해당 기능 플래그와 관련된 모든 이벤트가 지원되지 않는 버전에서 일어난 경우에만 제거합니다. 플래그가 아직 제거되지 않았다면 독자가 플래그 도입 시점을 알 수 있어야 합니다.

버전 제거 시기#

새 메이저 버전 릴리스가 임박하면 마지막으로 지원이 끝나는 버전에 대한 언급을 제거하는 머지 리퀘스트를 만듭니다. 머지는 새 메이저 릴리스의 마일스톤 기간에만 진행합니다.

예를 들어 GitLab 19.0이 다음 메이저 릴리스라면 다음과 같습니다.

• 지원되는 버전은 18, 17, 16입니다.
• GitLab 19.0이 릴리스되면 GitLab 16은 더 이상 지원되지 않습니다.

GitLab 16에 대한 언급을 제거하는 머지 리퀘스트를 만들되, 18.11이 릴리스된 후 19.0 마일스톤 기간에만 머지합니다.

가용성 세부 정보를 추가하는 경우#

다음 위치에 가용성 세부 정보를 지정합니다.

• 대부분의 H1 주제 제목. 단 doc/development/*와 doc/solutions/* 아래 페이지는 제외합니다.
• H1 제목과 가용성 세부 정보가 다른 기능의 주제 제목.

H1 가용성 세부 정보는 해당 페이지의 기능 중 가장 넓은 가용성에 해당하는 내용이어야 합니다. 예를 들면 다음과 같습니다.

• 일부 섹션은 Premium과 Ultimate에, 다른 섹션은 Ultimate에만 적용된다면 H1의 Tier:는 Premium, Ultimate여야 합니다.
• 일부 섹션은 모든 인스턴스에, 다른 섹션은 GitLab Self-Managed에만 적용된다면 Offering:은 GitLab.com, GitLab Self-Managed, GitLab Dedicated, GitLab Dedicated for Government여야 합니다.
• 일부 섹션은 beta이고 다른 섹션은 experiment라면 H1의 Status:는 Beta여야 합니다. 일부 섹션이 beta이고 다른 섹션이 일반 공급이라면 H1에는 Status:를 넣지 않습니다.

가용성 세부 정보를 추가하지 않는 경우#

다음 페이지에는 가용성 세부 정보를 지정하지 않습니다.

• 튜토리얼.
• 서로 다른 티어의 기능을 비교하는 페이지.
• /development 폴더의 페이지. 이 페이지에는 Contribute 배지가 자동으로 지정됩니다.
• /solutions 폴더의 페이지. 이 페이지에는 Solutions 배지가 자동으로 지정됩니다.

또한 기능에 명확한 구독 티어나 오퍼링이 하나로 정해지지 않는 경우에도 지정하지 않습니다. 예를 들어 어떤 기능이 GitLab.com에서는 한 티어에 적용되고 GitLab Self-Managed에서는 가용성이 다른 경우입니다.

이런 경우에는 다음 중 하나 또는 전부를 수행합니다.

• 메타데이터를 사용해 해당 페이지가 검토되었고 가용성 세부 정보가 필요하지 않음을 표시합니다.
• type="note" 알림 상자로 가용성 세부 정보를 설명합니다.
• 이 정보가 더 잘 맞는 다른 주제 제목 아래에 가용성 세부 정보를 추가합니다.
• H1 아래에는 가용성 세부 정보를 추가하지 않습니다.

하위 제목에서 티어, 오퍼링 또는 상태 중복#

하위 제목의 티어, 오퍼링, 상태가 상위 주제와 같다면 하위 제목의 배지에 그 정보를 반복할 필요가 없습니다.

예를 들어 Tier: Premium, Ultimate와 Offering: GitLab.com을 갖는 하위 제목은 페이지 세부 정보가 같다면 그 내용을 중복할 필요가 없습니다.

title: My title
---

티어는 다르지만 오퍼링이 같은 하위 수준 제목은 다음과 같습니다.

## My title



- Tier: Ultimate

인라인 가용성 세부 정보#

일반적으로 가용성 세부 정보를 다른 텍스트와 인라인으로 함께 넣지 않습니다. 기능의 단일 진실 공급원은 해당 기능이 설명된 주제여야 합니다.

가용성 세부 정보를 인라인으로 언급해야 한다면 일반 텍스트로 작성합니다. 예를 들어 API 주제에서는 다음과 같습니다.

IDs of the users to assign the issue to. Ultimate only.

더 많은 예시는 REST API 스타일 가이드를 참고합니다.

인라인 히스토리 텍스트#

기존 주제에 콘텐츠를 추가하는 경우에는 기존 텍스트와 인라인으로 이력 정보를 추가합니다. 가능하면 관련 이슈, 머지 리퀘스트, 에픽 링크를 포함합니다. 예를 들면 다음과 같습니다.

The voting strategy [in GitLab 13.4 and later](https://issue-link) requires the primary and secondary
voters to agree.