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

• 세부 정보가 페이지 전체에 적용되는 경우, 프론트매터 다음, 페이지 최상단에 배치합니다.

• 특정 섹션에만 적용되는 경우, 해당 섹션 제목 아래에 세부 정보를 배치합니다.

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

가용성 세부 정보의 Markdown은 다음과 같이 작성합니다:

title: 'Topic title'
---

<details class="history-toggle"><summary>히스토리</summary><ul><li><a href="https://issue-link">Introduced</a> in GitLab 16.3.</li>
<li>Updated in GitLab 16.4.</li></ul></details>

사용 가능한 옵션#

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

티어#

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

• Free, Premium, Ultimate

• Premium, Ultimate

• Ultimate

GitLab Dedicated 및 GitLab Dedicated for Government는 항상 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

페이지를 검토한 결과 GitLab Dedicated에 적용되지 않는다면, 메타데이터를 지정합니다.

상태#

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

• Beta

• Experiment

• Limited availability

일반적으로 사용 가능한(Generally available) 기능에는 상태를 표시하지 않습니다.

셀프 호스티드 모델을 사용하는 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 숏코드를 사용하여 버전 히스토리를 렌더링합니다. 예를 들면:

<details class="history-toggle"><summary>히스토리</summary><ul><li><a href="https://issue-link">Introduced</a> in GitLab 16.3.</li>
<li><a href="https://issue-link">Changed</a> in GitLab 16.4.</li></ul></details>

추가로:

• 히스토리 항목은 세부 정보(있는 경우) 다음에, 제목 바로 아래에 나열합니다.

• 출력이 올바르게 생성되는지 확인합니다.

• 버전 히스토리는 반드시 -로 시작합니다.

• 가능하면 관련 이슈에 대한 링크를 포함합니다. 관련 이슈가 없으면 머지 리퀘스트나 에픽에 링크합니다.

• 비공개 이슈에 링크하지 마세요.

• 가격 페이지에 링크하지 마세요.

• 하나의 티어에서 다른 티어로 변경되는 경우가 아니라면, 구독 티어를 포함하지 마세요.

업데이트된 기능#

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

예를 들면:

- [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.

기능 상태 변경#

실험(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)으로 변경되는 경우, 다음을 사용합니다:

- [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은 현재 주요 버전과 이전 두 개의 주요 버전을 지원합니다. 예를 들어, 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 마일스톤 중에만 머지합니다.

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

다음 항목에 가용성 세부 정보를 지정합니다:

• doc/development/* 및 doc/solutions/* 하위 페이지를 제외한 대부분의 H1 주제 제목.

• H1 제목과 다른 가용성 세부 정보를 가진 기능의 주제 제목.

H1 가용성 세부 정보는 페이지의 기능에 대해 가장 넓은 가용성에 적용되는 세부 정보여야 합니다. 예를 들면:

• 일부 섹션이 Premium과 Ultimate에 적용되고, 다른 섹션이 Ultimate에만 적용되는 경우, H1의 Tier:는 Premium, Ultimate이어야 합니다.

• 일부 섹션이 모든 인스턴스에 적용되고, 다른 섹션이 GitLab Self-Managed에만 적용되는 경우, Offering:은 GitLab.com, GitLab Self-Managed, GitLab Dedicated, GitLab Dedicated for Government이어야 합니다.

• 일부 섹션이 베타이고, 다른 섹션이 실험인 경우, H1의 Status:는 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

인라인 가용성 세부 정보#

일반적으로 다른 텍스트와 함께 인라인으로 가용성 세부 정보를 추가하지 않아야 합니다. 기능의 단일 진실 공급원(Single Source Of Truth, SSOT)은 기능이 설명된 주제이어야 합니다.

인라인으로 가용성 세부 정보를 언급해야 하는 경우, 일반 텍스트로 작성합니다. 예를 들어, 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.