개념 주제 유형

개념은 단일 기능 또는 컨셉트를 소개합니다.

개념은 다음 질문에 대답해야 합니다:

  • 이것은 무엇인가요?
  • 왜 사용해야 하나요?

만약 누군가가 이 개념을 들어보지 못했다면 알아둬야 할 모든 것을 생각해보세요.

어떻게 하는 것이 아니라 무엇인지 알려주십시오.

만약 다른 개념을 설명하기 시작한다면 새로운 개념을 시작하고 그것에 링크를 걸어주세요.

형식

개념은 다음 형식을 따라야 합니다: 

# 제목 (명사, 예: "위젯")

이 것이 무엇이고 왜 사용하는지 설명하는 한 두 단락.

만약 다른 개념을 설명하기 시작한다면 중단하세요.
각 개념은 **단 하나의 개념**에 대해 있어야 합니다.

**물건을 어떻게 사용하는지** 설명하기 시작한다면 중단하세요.
작업 주제는 어떻게 사용하는지를 설명하며, 개념 주제는 아닙니다.

관련 작업에 대한 링크를 포함하지 마세요. 내비게이션에서 작업에 대한 링크를 제공합니다.

개념 주제 제목

제목 텍스트에는 명사를 사용하세요. 예를 들면:

  • 위젯
  • GDK 의존성 관리

보다 구체적인 단어가 필요한 경우, ing 대신에 ion 버전의 단어를 사용하세요. 예를 들어:

  • 객체 이전 대신에 객체 이주

ing으로 끝나는 단어는 번역하기 어렵고 공간을 많이 차지하기 때문에, 작업 주제에는 적극적 동사가 사용됩니다. 세부 내용은 Google 스타일 가이드를 참조하세요.

피해야 할 제목

다음과 같은 주제 제목을 피하세요:

  • 개요 또는 소개. 대신에 누군가가 검색할 수 있는 보다 구체적인 명사나 구절을 사용하세요.
  • 사용 사례. 대신에 해당 정보를 개념의 일부로 통합하세요.
  • 작동 방식. 대신에 명사 뒤에 워크플로우를 사용하세요. 예를 들어, 병합 요청 워크플로우.