제품 버전 문서화
GitLab 제품 문서에는 버전별 정보가 포함되어 있습니다. 이는 기능이 도입된 시기 및 업데이트 또는 제거된 시기를 포함합니다.
오래된 문서 버전 보기
이전 버전의 문서는 docs.gitlab.com
에서 사용할 수 있습니다.
이전 버전을 보려면 오른쪽 상단에서 Versions를 선택합니다.
docs.gitlab.com
에서 사용할 수 없는 버전을 보려면:
버전별 기능 문서화
기능이 추가되거나 업데이트된 경우 History 디렉터리 항목이나 인라인 텍스트 참조로 문서를 업데이트하세요.
/development
디렉터리의 페이지에는 역사적 정보를 추가할 필요가 없습니다.
History 항목 추가
특정 주제의 모든 내용이 관련되는 경우, 주제 제목 뒤에 역사 항목을 추가하세요. 예:
## 기능 이름
> - [도입](<이슈 링크>) - GitLab 11.3에서.
이 기능은 어떤 작업을 수행합니다.
아이템 텍스트에는 다음 단어가 포함되어야 합니다. 대소문자는 중요하지 않습니다.
-
도입
,활성화
,폐지 예정
,변경
,이동
,권장
,제거
또는이름 변경
-
에서
또는로
-
GitLab
(또는 외부 프로젝트의 경우 프로젝트 이름)
문서 사이트는 Ruby 코드를 사용하여 이러한 단어를 기반으로 참조를 렌더링합니다.
추가로:
- 페이지의 다른 참조나 문서 사이트의 다른 참조와 일관성을 유지하세요.
- 출력물이 올바르게 생성됨을 확인하세요.
- 가능하면 관련된 이슈, Merge Request 또는 이픽에 대한 링크를 포함하세요.
- 요금 페이지에 연결하지 마세요. 구독 계층을 포함하지 마세요.
- 항목이 하나뿐이더라도 반드시
> -
로 시작됨을 확인하세요.
새로운 기능 도입
도입
을 사용하는 경우, 문장을 기능 이름 또는 동명사로 시작하세요:
> - 만료 토큰에 대한 알림 [도입](<이슈 링크>) - GitLab 11.3에서.
> - 이슈 보드에서 이슈 생성 [도입](<이슈 링크>) - GitLab 13.1에서.
구독 계층 변경
특정 기능이 다른 구독 계층으로 이동되면 이동
을 사용하세요:
> - GitLab Ultimate에서 GitLab Premium으로 [이동됨](<이슈 링크>) - 11.8 버전에서.
> - GitLab Premium에서 GitLab Free로 [이동됨](<이슈 링크>) - 12.0 버전에서.
기능 상태 변경
기능 상태가 변경된 경우 변경
을 사용하세요:
> - [도입됨](<이슈 링크>) - GitLab 15.7에서 [실험](../../policy/experiment-beta-support.md)으로.
> - Beta로 [변경됨](<이슈 링크>) - GitLab 16.0에서.
> - 일반 제공으로 [변경됨](<이슈 링크>) - GitLab 16.3에서.
피처 플래그로 도입된 기능
기능이 피처 플래그 뒤에 도입된 경우, 피처 플래그에 대한 세부 정보를 문서에 추가해야 합니다. 자세한 내용은 피처 플래그 뒤에 배포된 기능 문서화를 참조하세요.
인라인 역사 텍스트
기존 주제에 콘텐츠를 추가하는 경우 해당 내용에 역사 정보를 인라인으로 추가할 수 있습니다. 가능하면 관련 이슈, Merge Request 또는 이픽에 대한 링크를 포함하세요. 예:
투표 전략은 [GitLab 13.4 이후](<이슈 링크>)에 주요 투표자와 보조 투표자의 동의를 요구합니다.
폐지 및 제거
기능이 폐지되고 제거된 경우 관련 문서를 업데이트하세요.
페이지 또는 주제 폐지
페이지 또는 주제를 폐지하려면:
-
제목 뒤에
(폐지)
를 추가합니다. 폐지된 시기를 설명하는 경고문을 추가하세요. 삭제될 시기와 대체 기능을 설명하는 경고문을 사용하세요.## 제목 (폐지) DETAILS: **Tier**: Premium, Ultimate **Offering**: GitLab.com, Self-managed, GitLab Dedicated WARNING: 이 기능은 GitLab 14.8에서 [폐지될 예정](<이슈 링크>)이며 15.4에서 삭제됩니다. [기능 X](<문서 링크>)를 대신 사용하세요.
기능이 언제 제거될지 확실하지 않거나 대체 기능이 없는 경우, 이 정보를 추가할 필요가 없습니다.
-
변경사항이 주요 변경 사항인 경우, 다음 텍스트를 추가합니다:
이 변경사항은 주요 변경사항입니다.
사용자가 도움이 되는 추가 콘텍스트에 관련된 세부 정보를 추가할 수 있습니다.
-
콘텐츠 위와 아래에 다음 HTML 주석을 추가합니다.
remove_date
에는 제거될 릴리스에서 3개월 후의 날짜를 설정합니다.<!--- start_remove 다음 콘텐츠는 remove_date: 'YYYY-MM-DD'에 제거됩니다. --> ## 제목 (폐지) DETAILS: **Tier**: Premium, Ultimate **Offering**: GitLab.com, Self-managed, GitLab Dedicated WARNING: 이 기능은 GitLab 14.8에서 [폐지될 예정](<이슈 링크>)이며 15.4에서 삭제됩니다. [기능 X](<문서 링크>)를 대신 사용하세요. <!--- end_remove -->
-
페이지 제거 디렉터리에 Merge Request을 열어 왼쪽 탐색에서 페이지 제목 뒤에
(폐지)
라는 단어를 추가합니다.
페이지 제거
특정 기능이 제거된 릴리스에서 콘텐츠를 제거하세요. 제목과 삭제된 표시가 제거될 때까지는 유지됩니다.
페이지를 제거하려면:
- 페이지 제목은 유지합니다. 다른 모든 콘텐츠, 역사 항목 및
WARNING:
단어를 제거합니다. - 제목 뒤에
(제거됨)
으로 변경합니다. - YAML 메타데이터를 업데이트합니다:
-
remove_date
에는 해당 기능이 제거된 릴리스 후 3개월 후의 날짜를 설정합니다. -
redirect_to
에는 적합한 파일 경로를 설정합니다. 명확한 페이지가 없는 경우 문서 홈페이지를 사용합니다.
--- stage: 데이터 리포지터리 그룹: 글로벌 검색 정보: 이 페이지가 연결된 단계/그룹에 할당된 기술 작성자를 확인하려면 https://handbook.gitlab.com/handbook/product/ux/technical-writing/#assignments를 참조하십시오. remove_date: '2022-08-02' redirect_to: '../새로운경로/문서/index.md' --- # 제목 (제거됨) DETAILS: **Tier**: Premium, Ultimate **Offering**: GitLab.com, Self-managed, GitLab Dedicated 이 기능은 GitLab X.Y에서 [폐지됨](<이슈 링크>) 및 X.Y에서 [삭제됨](<이슈 링크>). [기능 X](<문서 링크>)를 사용하세요.
-
- 글로벌 탐색에서 해당 페이지의 항목을 삭제하기 위해
gitlab-docs
의navigation.yaml
을 편집합니다.
이 콘텐츠는 기술 작성 팀의 정기 예약 작업의 일환으로 문서에서 삭제됩니다.
Remove a topic (removed)
This feature was deprecated in GitLab X.Y and removed in X.Y. Use feature X instead.
```
이 내용은 기술 서적팀의 정기 업무 일환으로 문서에서 제거되었습니다.