# 테마 가져오기에서 오해의 소지가 있는 "branch" 입력 필드

**URL:** https://meta.discourse.org/t/misleading-branch-input-in-theme-import/404507
**Category:** UX
**Tags:** fixed
**Created:** [6월 4, 2026, 9:23오전 UTC](https://meta.discourse.org/t/misleading-branch-input-in-theme-import/404507 "2026-06-04T09:23:24Z")
**Posts on this page:** 9
**Page:** 1

<div class="post-metadata">

### Author: ![RGJ](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/rgj/32/523185_2.png) [@RGJ](https://meta.discourse.org/u/RGJ)
#### Post date: [6월 4, 2026, 9:23오전 UTC](https://meta.discourse.org/t/misleading-branch-input-in-theme-import/404507/1 "2026-06-04T09:23:24Z")

</div>

@angus와 저는 테마가 GitHub에서 업데이트되었을 때 업데이트되지 않은 원인을 파악하는 데 꽤 오랜 시간을 보냈습니다. 결국 테마가 `main` 대신 `d-compat/2026.5`에서 가져와지고 있다는 것을 발견했습니다.

알고 보니, 브랜치 팝업에는 "branch: `main`"이라고 표시되어 있지만, 이 값을 비워 두면 `main`은 입력 필드의 플레이스홀더일 뿐 미리 채워진 값이 아니기 때문에 브랜치가 `nil`로 설정됩니다.

 ![image](https://global.discourse-cdn.com/meta/original/4X/e/e/7/ee7c95f3b91201a524883fabfa0e0f1c6e40f248.png)

---

<div class="post-metadata">

### Author: ![chapoi](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/chapoi/32/537252_2.png) [@chapoi](https://meta.discourse.org/u/chapoi)
#### Post date: [6월 4, 2026, 10:04오전 UTC](https://meta.discourse.org/t/misleading-branch-input-in-theme-import/404507/2 "2026-06-04T10:04:01Z")

</div>

이것은 UX 문제라기보다는 버그라고 부르고 싶을 정도입니다 (아, 그리고 어떻게 고쳐야 할지 저도 잘 모르겠네요). 그래서 엔지니어에게 알립니다. @martin 님, 관리자 쪽에 경험이 있으신가요? 한번 확인해 주시거나 트리아지(triage)를 해 주실 수 있을까요?

---

<div class="post-metadata">

### Author: ![RGJ](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/rgj/32/523185_2.png) [@RGJ](https://meta.discourse.org/u/RGJ)
#### Post date: [6월 4, 2026, 11:20오전 UTC](https://meta.discourse.org/t/misleading-branch-input-in-theme-import/404507/3 "2026-06-04T11:20:11Z")

</div>

> [@chapoi](#):
>
> 이것은 UX 문제가 아니라 버그라고 해도 될 것 같습니다.

그렇게 확신할 수는 없겠네요… 플레이스홀더를 "특정 브랜치를 선택하거나 비워 두세요"로 변경하면 충분히 해결될 것 같습니다.

---

<div class="post-metadata">

### Author: ![chapoi](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/chapoi/32/537252_2.png) [@chapoi](https://meta.discourse.org/u/chapoi)
#### Post date: [6월 4, 2026, 11:22오전 UTC](https://meta.discourse.org/t/misleading-branch-input-in-theme-import/404507/4 "2026-06-04T11:22:18Z")

</div>

> [@RGJ](#):
>
> “특정 브랜치를 선택하거나 비워 두세요”

그렇게 하면 같은 문제가 발생하지 않을까요? 입력을 비워 두면(플레이스홀더를 신뢰하고) 결국 기본값이 nil로 돌아가게 됩니다?

이상적인 상태는 main으로 기본 설정되는 것이라고 생각합니다.

---

<div class="post-metadata">

### Author: ![RGJ](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/rgj/32/523185_2.png) [@RGJ](https://meta.discourse.org/u/RGJ)
#### Post date: [6월 4, 2026, 11:40오전 UTC](https://meta.discourse.org/t/misleading-branch-input-in-theme-import/404507/5 "2026-06-04T11:40:36Z")

</div>

> [@chapoi](#):
>
> 기본값이 main인 것이 이상적인 상태라고 생각하는데?

아니요.

빈 상태로 두면 올바른 `d-compat` 분기가 자동으로 선택됩니다.

`main`으로 설정하면 이를 무시하고 `main` 분기를 강제로 사용하게 됩니다.

> [@chapoi](#):
>
> 입력란을 비워두면 됩니다(플레이스홀더를 신뢰하는 방식)

문제는 현재 플레이스홀더가 비워두면 `main`이 선택된다는 것을 암시하고 있다는 점입니다.  
그런 암시를 하지 않는 문구로 변경하면 혼란이 사라질 것입니다.

---

<div class="post-metadata">

### Author: ![chapoi](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/chapoi/32/537252_2.png) [@chapoi](https://meta.discourse.org/u/chapoi)
#### Post date: [6월 4, 2026, 11:43오전 UTC](https://meta.discourse.org/t/misleading-branch-input-in-theme-import/404507/6 "2026-06-04T11:43:45Z")

</div>

아, 알겠습니다. 설명해 주셔서 감사합니다 – 이 부분은 제가 잘 모르는 분야라서요.

말씀하신 대로 맞는 것 같습니다. 쉽게 바꿀 수 있겠네요.

---

<div class="post-metadata">

### Author: ![chapoi](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/chapoi/32/537252_2.png) [@chapoi](https://meta.discourse.org/u/chapoi)
#### Post date: [6월 5, 2026, 11:05오전 UTC](https://meta.discourse.org/t/misleading-branch-input-in-theme-import/404507/8 "2026-06-05T11:05:18Z")

</div>

완료했습니다.

> <https://github.com/discourse/discourse/pull/40603>
>
> \* Changed incorrect placeholder + make translatable
> \* Remove dead \`his.urlPlace…holder\`
> \[ref\](https://meta.discourse.org/t/misleading-branch-input-in-theme-import/404507)

감사합니다

---

<div class="post-metadata">

### Author: ![system](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/system/32/443519_2.png) [@system](https://meta.discourse.org/u/system)
#### Post date: [6월 5, 2026, 11:05오전 UTC](https://meta.discourse.org/t/misleading-branch-input-in-theme-import/404507/9 "2026-06-05T11:05:27Z")

</div>



---

<div class="post-metadata">

### Author: ![david](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/david/32/157490_2.png) [@david](https://meta.discourse.org/u/david)
#### Post date: [6월 8, 2026, 4:45오후 UTC](https://meta.discourse.org/t/misleading-branch-input-in-theme-import/404507/10 "2026-06-08T16:45:26Z")

</div>

> [@RGJ](#):
>
> 결국 테마가 `main`이 아닌 `d-compat/2026.5`에서 가져오고 있다는 사실을 발견했습니다.

방금 이 PR을 열었습니다. 이 PR은 UI에 **실제로 설치된** 브랜치 이름과 업데이트를 위한 해석된 대상 브랜치 이름을 추가합니다:

> <https://github.com/discourse/discourse/pull/40649>
>
> When a remote theme is installed or updated from a git repository, Discourse may… check out a compatibility-pinned ref (a \`d-compat/YYYY.MM\` branch or a \`.discourse-compatibility\` entry) rather than the requested branch.
> 
> Previously this wasn't obvious in the UI. This commit surfaces the currently-running compatibility reference, and the compatibility reference of any pending update.
> 
> \<img width="650" height="293" alt="image" src="https://github.com/user-attachments/assets/11137fbd-e6e3-4786-8234-5799965d05c6" /\>
