GitHub 통합

GitHub은 개발팀과 회사가 소프트웨어를 개발하고, 출시하고, 유지하는 데 사용되는 유용한 툴입니다. 필터, 보기, 관계형 등의 강력한 기능을 제공하는 Notion의 데이터베이스를 활용하여 GitHub을 Notion 워크플로 전체에 연결해 보세요.

Notion 워크스페이스 소유자이면서 GitHub 조직 관리자인 사람만 Notion과 GitHub 워크스페이스 앱을 연결할 수 있습니다.

• 사이드바 상단에 있는 설정과 멤버로 이동하세요.

• 내 연결을 클릭하고 GitHub(워크스페이스)을 찾으세요.

• 연결을 클릭하고 인증 절차를 완료하세요.

Notion의 파일 또는 파일의 특정 라인으로 바로 링크하세요. 최신 버전의 코드 참조를 원한다면 특정 커밋 또는 브랜치를 링크할 수도 있습니다.

링크하는 방법은 GitHub에서 원하는 줄의 퍼머링크를 복사하여 Notion 페이지에 붙여넣기만 하면 됩니다. 표시되는 더보기에서 미리보기로 붙여넣기를 선택하여 코드를 원하는 페이지에 임베드하세요.

Notion 데이터베이스 안의 GitHub 풀 리퀘스트 속성은 협업팀들에게 작업 상태를 자동으로 알려줍니다. 롤업, 수식, 필터 등에 사용할 수 있는 여러 속성도 함께 활용하세요.

• Notion 데이터베이스에서 +를 클릭하여 새로운 속성을 추가하세요.

• 이 속성을 데이터베이스에 추가하려면 GitHub 풀 리퀘스트를 검색하고 클릭하세요.

• 데이터베이스에는 고유 ID 속성이 있어야 합니다. 고유 ID 속성이 없으면 이 속성이 데이터베이스에 추가됩니다.

• GitHub 풀 리퀘스트 속성을 사용하려면 GitHub 계정을 Notion에 연결했는지 확인하세요. 그 다음, 풀 리퀘스트에 Notion 작업의 고유 ID를 추가하거나 GitHub 풀 리퀘스트 URL을 속성에 붙여넣으세요.

Notion 작업에서 GitHub로의 백링크가 기본적으로 허용됩니다. 이 기능을 해제하려면 데이터베이스에서 GitHub 풀 리퀘스트 속성 → 속성 편집을 클릭하고 GitHub에서 링크백 토글을 끄세요.

GitHub 풀 리퀘스트 속성을 사용하여 Notion에서 작업 상태를 자동으로 업데이트할 수 있습니다.

• GitHub 풀 리퀘스트 속성의 제목을 선택하고 속성 편집을 클릭하세요.

• 자동 업데이트 섹션을 찾아 드롭다운 메뉴에서 업데이트할 상태 속성을 선택하세요.

• GitHub PR의 상태가 오픈, 리뷰 요청, 승인됨, 머지됨일 때 Notion에 설정될 작업 상태를 선택하세요.

• 이제 GitHub에서 PR 상태가 변경되면 Notion 작업 상태도 설정에 따라 자동으로 업데이트됩니다.

링크된 Notion 작업에서 GitHub 활동을 표시할 수도 있습니다. 데이터베이스의 GitHub 속성 → 속성 편집을 클릭하고 활동 코멘트를 활성화하세요.

GitHub PR을 하나 이상의 Notion 작업에 링크하려면 PR의 설명에 매직워드와 Notion 작업의 고유 ID를 입력하세요.

매직워드는 Notion 작업과 GitHub PR 간의 관계 설정을 돕는 핵심 단어입니다. 다음과 같은 단어를 사용하세요.

• close, closes, closed

• fix, fixes, fixed

• resolve, resolves, resolved

• complete, completes, completed, completing

• ref, references

• part of

• related to

• contributes to

• towards

예를 들어 PR 설명에 'CTT-13 수정'을 넣을 수 있습니다. 해당 설명이 설정되면 ID가 CTT-13인 Notion 작업은 해당 PR과 링크됩니다.

PR 설명에 작업 종료 또는 완료가 연상되는 매직워드를 사용하는 경우, PR이 머지될 때 Notion 작업이 완료된 것으로 표시됩니다.

PR 설명에 작업 참조나 관련이 연상되는 매직워드를 사용하는 경우, PR이 머지될 때 Notion 작업이 완료된 것으로 표시되지 않습니다.

또한, Notion 작업을 참조 전용으로 링크하면 해당 작업이 완료된 것으로 표시되지 않습니다.