Skip to main content

Enterprise Server 3.15 은(는) 현재 릴리스 후보로 제공됩니다.

참조 콘텐츠 형식

참조 콘텐츠는 기능을 적극적으로 사용하는 동안 필요로 하는 자세한 정보를 제공합니다.

다른 문서 내에서 참조 문서 및 참조 구역을 만듭니다.

  • 특히 GitHub Actions의 검색 구문 또는 YAML 구문과 같은 많은 양의 참조 콘텐츠가 있는 경우, 일부 주요 주체에는 자체 참조 문서가 필요할 수 있습니다.
  • 기능의 지원되는 언어 또는 하드웨어 요구 사항 목록과 같은 더 적은 양의 콘텐츠 또는 보다 구체적인 정보의 경우 절차 또는 개념 문서 내의 컨텍스트에서 참조 구역을 사용하세요.

참조 콘텐츠 작성 방법

참조 콘텐츠 템플릿은 ‘템플릿’을(를) 참조하세요.

  • 문장 또는 전체 개념 구역을 작성하여 참조 콘텐츠를 소개하세요.
  • 실제 참조 콘텐츠를 명확하고 일관되게 표시하세요.
  • 설명할 단일 요소가 있는 주체의 경우 목록을 사용하세요.
  • 설명할 요소가 여러 가지 있는 주체의 경우 표를 사용하세요.
  • 워크플로에 대한 YAML 구문과 같은 더 긴 참조 콘텐츠의 경우 머리글을 일관되게 사용하세요.

참조 콘텐츠 제목

  • 참조 구역의 참조 문서 또는 머리글은 구역의 내용을 명확하게 설명하고 일반적으로 명사로 시작하세요.
  • 제목에는 초보 사용자가 액세스할 수 있는 충분한 정보가 포함되어 있으며 각 구역의 내용을 완전히 설명하세요.
  • 제목은 겹친 명사를 쓰지 말고, 전치사로 긴 명사 문자열을 분리하세요.

참조 콘텐츠의 예시