GitHub 원박스에서 실시간 Pull Request 상태 보기 ✨

새로운 기능을 발표하게 되어 매우 기쁩니다. discourse-github 플러그인용 기능으로, GitHub PR 원박스(Onebox)에 실시간 풀 리퀘스트 상태 표시기를 추가했습니다! :tada:

게시물이나 채팅 메시지에 GitHub 풀 리퀘스트 URL을 붙여넣으면, Discourse가 PR의 현재 상태를 보여주는 시각적 상태 아이콘을 표시합니다. 웹훅(Webhook)을 통해 자동으로 최신 상태로 유지됩니다. :counterclockwise_arrows_button:

기능 설명

GitHub PR 원박스는 이제 풀 리퀘스트의 현재 상태를 반영하는 상태 아이콘을 표시합니다:

상태 색상 설명
:memo: Draft(초안) 회색 PR이 초안으로 표시됨
:unlocked: Open(열림) 회색 PR이 열려 있으며 검토 대기 중
:white_check_mark: Approved(승인됨) 초록색 검토자가 PR을 승인함
:large_orange_diamond: Changes Requested(변경 요청됨) 주황색 검토자가 변경을 요청함
:purple_circle: Merged(병합됨) 보라색 PR이 병합됨
:red_circle: Closed(닫힘) 빨간색 병합되지 않고 PR이 닫힘

이 아이콘들은 GitHub의 네이티브 아이콘과 색상 스킴을 사용하므로, GitHub를 자주 사용하는 사용자에게 익숙하게 느껴질 것입니다. :eyes:

예시

여기서는 실제 동작 중인 다양한 상태의 모습을 보여드립니다:

초안(Draft) PR:

열린(Open) PR:

승인된(Approved) PR:

변경 요청(Changes Requested):

병합된(Merged) PR:

닫힌(Closed) PR:

작동 범위 :round_pushpin:

실시간 상태는 다음 위치에 표시됩니다:

  • 포럼 게시물 — GitHub PR 원박스가 포함된 모든 게시물
  • 채팅 메시지 — Chat 플러그인이 활성화된 경우, 채팅 내 PR 원박스에도 실시간 상태가 표시됩니다 :speech_balloon:

채팅 예시:

참고: 인라인 원박스(텍스트 중간에 링크가 전체 미리보기가 아닌 인라인으로 나타나는 경우)에는 상태 아이콘이 표시되지 않습니다.

웹훅을 통한 실시간 업데이트 :high_voltage:

이 기능의 가장 강력한 측면은 GitHub에서 변경 사항이 발생하면 PR 상태가 자동으로 업데이트된다는 점입니다. PR이 열리거나, 닫히거나, 병합되거나, 초안으로 전환되거나/초안에서 해제되거나, 리뷰를 받으면 Discourse는 해당 PR의 원박스가 포함된 게시물이나 채팅 메시지를 자동으로 업데이트합니다.

스마트 리뷰 상태 :magnifying_glass_tilted_left:

이 기능은 단순히 열림/닫힘 상태만 표시하는 것이 아니라, 승인되었거나 변경이 요청되었는지 판단하기 위해 리뷰 정보도 가져옵니다. 여러 검토자가 있는 경우 다음과 같이 지능적으로 처리합니다:

  • 각 검토자의 최신 리뷰를 기준으로 합니다.
  • 어느 검토자라도 변경을 요청한 경우 "변경 요청됨"을 표시합니다.
  • 리뷰가 존재하고 변경 요청이 없는 경우에만 "승인됨"을 표시합니다.

GitHub Status 테마 컴포넌트에서 마이그레이션 :warning:

이 기능은 GitHub Status Indicators 테마 컴포넌트를 대체합니다. 두 기능은 호환되지 않으며 함께 사용해서는 안 됩니다.

현재 테마 컴포넌트를 사용 중이라면 다음을 수행해야 합니다:

  1. github-status-theme 테마 컴포넌트를 비활성화하고 제거합니다.
  2. 사이트 설정을 통해 이 새로운 내장 기능을 활성화합니다.

새로운 구현 방식은 테마 컴포넌트보다 다음과 같은 여러 장점을 제공합니다:

  • :locked: 비공개 저장소와 작동 (API 인증을 통해)
  • :white_check_mark: 리뷰 기반의 승인/변경 요청 상태 포함
  • :high_voltage: 웹훅을 통한 실시간 업데이트
  • :speech_balloon: 채팅 메시지에서 작동
  • :hammer_and_wrench: 테마 컴포넌트 유지보수 불필요

시작하기 :rocket:

설정 방법, 구성 옵션 및 기술적 세부 사항은 discourse-github 플러그인 문서를 참고하세요.

피드백 :speech_balloon:

이 기능에 대한 여러분의 피드백을 듣고 싶습니다! 문제가 발생하거나 개선 사항에 대한 제안이 있다면, 아래 댓글로 알려주세요. :folded_hands:

33개의 좋아요

와! 이거 정말 좋아해요! :star_struck: 제가 드릴 피드백은 하나뿐인데, 이전에 사용하던 상태의 텍스트 표기가 그리워요. 컬러 아이콘은 멋지긴 한데, GitHub에 오래 머물지 않다 보니 어떤 의미를 가지는지 바로 파악이 안 돼요.

시간이 지나봐야 알겠지만, 버그 수정이나 새로운 기능의 상태를 확인하려는 다른 사용자들도 같은 문제를 겪고, 실제로는 변한 게 없는데 Discourse에서 무언가 바뀌었다고 생각할 수도 있을 것 같아요.

4개의 좋아요

아이콘에는 마우스를 올렸을 때 제목이 표시되지만, 이는 데스크톱에서만 작동합니다.

2개의 좋아요

이 말을 듣고 두 가지를 모두 가질 수 있겠구나라는 생각이 들었습니다 :wink:

8개의 좋아요

이건 이제 '병합됨’으로 표시되어야 하는 건가요? 제 화면에는 여전히 '열림’으로 나와요:

2개의 좋아요

아직 메타의 원박스 중 어떤 것도 다시 빌드하지 않았습니다.

2개의 좋아요

아, 내 실수였어. 마법이 너무 많이 일어날 줄 알았지 :magic_wand::slight_smile:

2개의 좋아요

참조하신 항목을 다시 빌드했습니다. 이제 올바르게 보이나요?

4개의 좋아요

다른 언어로 주제를 읽지 않는 한 상태만 표시되는 것을 확인했습니다. 알려진 트레이드오프인가요?

1개의 좋아요

원박스(Oneboxes)는 게시물의 원본 콘텐츠의 일부가 아니므로 번역되지 않습니다.

1개의 좋아요

제 질문은 번역에 관한 것이 아니라 상태 아이콘에 관한 것이었습니다. 번역된 게시물에서는 왜 동일한 방식으로 작동하지 않는지 궁금합니다.

테마 구성요소는 둘 다에서 작동했습니다.


아, 그렇군요. 왜 그런지 잘 모르겠네요. 한번 확인해볼게요 :eyes:

2개의 좋아요

게시물의 번역 버전에서 원박스(onebox)를 업데이트하는 것에 대해 새로운 소식이 있나요?

인라인 원박스에서 PR 상태를 지원하게 되었다는 소식을 전하게 되어 기쁩니다:

9개의 좋아요

커뮤니티가 gitea 지원을 고려하고 있는지 궁금합니다 :grinning_face: 특별한 사유로 GitHub에 접근할 수 없거나 속도가 매우 느립니다.

2개의 좋아요