개념 콘텐츠는 명확하고 높은 수준의 개요, 기능 또는 토픽이 경험에 도움이 되는 방법에 대한 설명, 사용 사례 또는 예시와 같은 컨텍스트를 제공하여 기능 또는 토픽을 이해하는 데 도움이 됩니다.
다른 문서 내에서 개념 문서 및 개념 구역을 만듭니다. 대부분의 주요 제품, 기능 또는 주체는 고유한 개념 문서가 있습니다.
개념 콘텐츠 작성 방법
개념적 콘텐츠 템플릿은 ‘템플릿’을(를) 참조하세요.
- 기능, 제품 또는 토픽이 무엇인지 쉬운 언어로 설명하세요.
- 해당 목적과 독자에게 유용한 이유를 설명하세요.
- 사용 사례 또는 예시를 공유하세요.
- 관련된 경우, 기능 또는 토픽의 작동 방식을 설명하세요(대상 그룹 및 기술 세부 정보에 대한 심층 분석을 위한 적절한 위치를 염두에 두어야 합니다).
- 이 기능을 사용하기 위해 독자가 알아야 할 세부 정보를 강조 표시하세요.
- 기능 시작에 대한 다음 단계를 포함하세요(추가 읽기 링크 또는 문서 자체 내의 콘텐츠를 통해).
개념적 콘텐츠의 제목
- 개념적 구역의 개념 문서 또는 머리글은 ‘[주체]의 정보’로 시작합니다.
- 명사로 주체를 설명하세요.
- 사용하세요: ‘code scanning 정보’
- 피하세요: ‘코드에서 취약성을 검사하는 방법’
개념적 콘텐츠의 예시
- 개념 문서
- 다른 문서 내의 개념 구역
- Adding a security policy to your repository(리포지토리에 보안 정책 추가)의 ‘보안 정책 정보’
- 유지 관리 모드 사용 설정 및 예약의 ‘유지 관리 모드의 정보’