다른 문서 내에서 참조 문서 및 참조 구역을 만듭니다.
- 특히 GitHub Actions의 검색 구문 또는 YAML 구문과 같은 많은 양의 참조 콘텐츠가 있는 경우, 일부 주요 주체에는 자체 참조 문서가 필요할 수 있습니다.
- 기능의 지원되는 언어 또는 하드웨어 요구 사항 목록과 같은 더 적은 양의 콘텐츠 또는 보다 구체적인 정보의 경우 절차 또는 개념 문서 내의 컨텍스트에서 참조 구역을 사용하세요.
참조 콘텐츠 작성 방법
참조 콘텐츠 템플릿은 ‘템플릿’을(를) 참조하세요.
- 문장 또는 전체 개념 구역을 작성하여 참조 콘텐츠를 소개하세요.
- 실제 참조 콘텐츠를 명확하고 일관되게 표시하세요.
- 설명할 단일 요소가 있는 주체의 경우 목록을 사용하세요.
- 예시: 조직의 리포지토리 역할
- 설명할 요소가 여러 가지 있는 주체의 경우 표를 사용하세요.
- 예시: 조직의 리포지토리 역할
- 워크플로에 대한 YAML 구문과 같은 더 긴 참조 콘텐츠의 경우 머리글을 일관되게 사용하세요.
- 각 고유 구역에 대한 H2 머리글.
- 예시와 같은 하위 구역에 대한 H3 머리글.
- 예시: GitHub Actions에 대한 워크플로 구문
참조 콘텐츠 제목
- 참조 구역의 참조 문서 또는 머리글은 구역의 내용을 명확하게 설명하고 일반적으로 명사로 시작하세요.
- 제목에는 초보 사용자가 액세스할 수 있는 충분한 정보가 포함되어 있으며 각 구역의 내용을 완전히 설명하세요.
- 제목은 겹친 명사를 쓰지 말고, 전치사로 긴 명사 문자열을 분리하세요.
참조 콘텐츠의 예시
- 참조 문서
- 바로 가기 키
- 엔터프라이즈에서의 역할
- REST API 설명서의 청구에 대한 REST API 엔드포인트
- GraphQL API 설명서의 변형
- 다른 문서 내의 참조 구역
- GitHub 모바일의 ‘지원되는 언어’
- AWS에 GitHub Enterprise Server 설치의 ‘하드웨어 고려 사항’