# 검색에서 #documentation을 더 눈에 띄게 만들기

**URL:** https://meta.discourse.org/t/making-documentation-more-prominent-in-search/263206
**Category:** Site feedback
**Created:** [4월 28, 2023, 2:05오후 UTC](https://meta.discourse.org/t/making-documentation-more-prominent-in-search/263206 "2023-04-28T14:05:23Z")
**Posts on this page:** 14
**Page:** 1

<div class="post-metadata">

### Author: ![pfaffman](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/pfaffman/32/120154_2.png) [@pfaffman](https://meta.discourse.org/u/pfaffman)
#### Post date: [4월 28, 2023, 2:05오후 UTC](https://meta.discourse.org/t/making-documentation-more-prominent-in-search/263206/1 "2023-04-28T14:05:23Z")

</div>

이것이 새 주제로 만들어져야 하는지, 아니면 검색에 관한 것인지(관련 주제가 있긴 한데 찾을 수가 없습니다) 잘 모르겠습니다. 누군가 슬로우 모드(slow mode)가 무엇인지 물어보았습니다. 검색해 보았지만 찾을 수 없었습니다. (지난 7년간 #Contribute > Feature 관련 주제를 모두 읽었기 때문에, 실제로 한 번도 본 적은 없지만 슬로우 모드가 무엇인지는 알고 있습니다).

[“slow mode”](https://meta.discourse.org/search?q=slow%20mode)로 검색하면 [https://meta.discourse.org/t/slow-mode-appreciation/219373를](https://meta.discourse.org/t/slow-mode-appreciation/219373%EB%A5%BC) 찾을 수 있는데, 여기에는 답이 있을 수도 있습니다.

설정을 "slow mode"로 검색하면 "'Slow Mode’는 editing\_grace\_period 이후 편집을 방지합니까?"라는 항목이 나오지만, 여전히 슬로우 모드가 무엇인지 알 수 있는 방법은 없습니다.

몇 번의 시도는 "slow database"에 대한 주제를 가져오는 것 같았는데, 이게 좋을까요.

관련해서, #how-to나 #announcements의 검색 우선순위를 높여야 할까요?

---

<div class="post-metadata">

### Author: ![Lilly](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/lilly/32/575047_2.png) [@Lilly](https://meta.discourse.org/u/Lilly)
#### Post date: [4월 28, 2023, 2:22오후 UTC](https://meta.discourse.org/t/making-documentation-more-prominent-in-search/263206/2 "2023-04-28T14:22:01Z")

</div>

음, 슬로우 모드에 대한 검색 결과 중 하나로 이 주제를 찾았지만, 목록 상단에 있지는 않았어요:

> [@“slow” 모드란 무엇인가요?](https://meta.discourse.org/t/what-is-slow-mode/236611):
>
> Having some real trouble finding docs for newbs. Could someone please tell me what “slow” mode actually is? thanks!

---

<div class="post-metadata">

### Author: ![pfaffman](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/pfaffman/32/120154_2.png) [@pfaffman](https://meta.discourse.org/u/pfaffman)
#### Post date: [4월 28, 2023, 4:54오후 UTC](https://meta.discourse.org/t/making-documentation-more-prominent-in-search/263206/3 "2023-04-28T16:54:32Z")

</div>

조급했던 것 같네요. 🙂

하지만 @JammyDodger 님, 슬로우 모드는 별도 주제를 가질 만합니다. 좋은 답변을 찾지 못한 것이 검색의 탓은 아닐 수 있어요 (물론 질문하신 분께는 꽤 좋은 답변이었지만요).

---

<div class="post-metadata">

### Author: ![Lilly](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/lilly/32/575047_2.png) [@Lilly](https://meta.discourse.org/u/Lilly)
#### Post date: [4월 28, 2023, 5:43오후 UTC](https://meta.discourse.org/t/making-documentation-more-prominent-in-search/263206/4 "2023-04-28T17:43:16Z")

</div>

정확히 말하자면, 전체 결과 페이지를 보기 위해 "더 보기"를 클릭하고 스크롤해야 했습니다. 바로 보이는 팝업 결과 목록에는 없었거든요. 🙂

---

<div class="post-metadata">

### Author: ![JammyDodger](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jammydodger/32/254611_2.png) [@JammyDodger](https://meta.discourse.org/u/JammyDodger)
#### Post date: [4월 28, 2023, 6:54오후 UTC](https://meta.discourse.org/t/making-documentation-more-prominent-in-search/263206/5 "2023-04-28T18:54:33Z")

</div>

> [@pfaffman](#):
>
> 하지만 또한, @JammyDodger , 슬로우 모드는 별도의 주제(topic)를 가질 자격이 있을지도 모릅니다. 좋은 답변을 찾지 못한 것이 검색의 탓이 아닐 수도 있습니다(물론 질문한 사람에게 있어서는 꽤 좋은 답변이었지만요).

그 전에 이미 하나 아직 그런 것이 없다고 생각한다는 답변을 시작했는데, 내가 하나를 작성하겠다고 자원하는 것처럼 들리지 않으면서도 그 뜻을 전할 말을 좀처럼 찾지 못했습니다… 🙂

하지만 아니요, 하나를 가지는 것이 좋을 것 같습니다. 👍 제 목록에 추가하겠습니다. 📝

> [@pfaffman](#):
>
> 관련된 참고로, #how-to 와 더 높은 검색 우선순위를 가진 #announcements::category 가 있나요?

#Support 가 'low’로 설정되어 있으면 나머지는 자동으로 우선순위가 올라가므로, 이것이 필요하지 않을 수도 있습니다. 🤔 이미 존재하는 것을 검색하면 더 좋은 결과가 나올지 궁금합니다.

**즉각적인 업데이트:** 아니요, 그렇지 않습니다. 🙂 'invites’와 'whispers’를 검색해 보았는데 #documentation보다 #Contribute > Feature 와 #Contribute > Bug 주제들이 더 많이 나왔습니다. 이 부분을 조금 조정해 보고 차이가 나는지 확인해 보겠습니다.

---

<div class="post-metadata">

### Author: ![JammyDodger](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jammydodger/32/254611_2.png) [@JammyDodger](https://meta.discourse.org/u/JammyDodger)
#### Post date: [4월 28, 2023, 7:19오후 UTC](https://meta.discourse.org/t/making-documentation-more-prominent-in-search/263206/6 "2023-04-28T19:19:16Z")

</div>

#Documentation 하위 카테고리는 이미 모두 'high’로 설정되어 있었습니다. 이를 'very high’로 높였는데, 결과물에서 훨씬 더 두드러지게 보였지만, 다른 항목들을 거의 가려버릴 정도로 _너무_ 과할 수도 있다고 생각합니다. 그래서 (적어도 당분간은) 다시 'high’로 낮췄습니다.

검색 시 `in:docs` 또는 `#documentation`을 추가하는 것은 유용하지만, 사람들이 이를 알고 있고 (사용을 잊지 않고) 사용해야 한다는 점에 의존합니다. [Documentation - Discourse Meta](https://meta.discourse.org/docs) 목록을 검색하는 것도 좋으며, 새로운 사용자들에게는 찾는 것이 더 쉬울 수도 있습니다?

---

<div class="post-metadata">

### Author: ![pfaffman](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/pfaffman/32/120154_2.png) [@pfaffman](https://meta.discourse.org/u/pfaffman)
#### Post date: [4월 28, 2023, 7:34오후 UTC](https://meta.discourse.org/t/making-documentation-more-prominent-in-search/263206/7 "2023-04-28T19:34:24Z")

</div>

아, 그렇군요. [Documentation - Discourse Meta](https://meta.discourse.org/docs) 가 신규 사용자가 참고해야 할 곳이 분명합니다. 사이드바에서 이 링크가 더 눈에 띄게 배치되면 좋겠다고 생각합니다. 현재로서는(제가 볼 수 있는 한) "더 보기"를 클릭한 뒤 문서 링크를 찾아야 합니다. 상당히 직관적이지 않은 것 같습니다. (그리고 이제 이 주제를 제가 좀 뺏어간 것 같네요. 여기선 다루기 부적합한 내용인 것 같아서요.).

---

<div class="post-metadata">

### Author: ![sam](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/sam/32/102149_2.png) [@sam](https://meta.discourse.org/u/sam)
#### Post date: [4월 29, 2023, 5:00오전 UTC](https://meta.discourse.org/t/making-documentation-more-prominent-in-search/263206/8 "2023-04-29T05:00:54Z")

</div>

현재 부밍(추돌)은 정상적으로 작동하는 것으로 보이는데?

 ![image](https://global.discourse-cdn.com/meta/original/4X/3/9/2/392b0c92822f0d00a107b708f7c970de98337386.png)

---

<div class="post-metadata">

### Author: ![JammyDodger](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jammydodger/32/254611_2.png) [@JammyDodger](https://meta.discourse.org/u/JammyDodger)
#### Post date: [4월 29, 2023, 5:37오전 UTC](https://meta.discourse.org/t/making-documentation-more-prominent-in-search/263206/9 "2023-04-29T05:37:48Z")

</div>

‘invites’, ‘whispers’, 'polls’을 가지고 대충 한번 훑어보았습니다 (아주 즉흥적인 시도였어요) 그리고 #documentation은 첫 번째로 떠오르지 않았어요.

`in:docs`는 아주 잘 작동합니다.

---

<div class="post-metadata">

### Author: ![sam](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/sam/32/102149_2.png) [@sam](https://meta.discourse.org/u/sam)
#### Post date: [5월 10, 2023, 1:08오전 UTC](https://meta.discourse.org/t/making-documentation-more-prominent-in-search/263206/10 "2023-05-10T01:08:37Z")

</div>

아니, 여기 엣지 케이스를 발견하셨네요…

제목: `invite something invite`

**우선순위** 가 지정된 카테고리의 다음 제목보다 검색에서 더 높은 순위를 차지합니다:

제목: `invite only once`

* * *

 ![image](https://global.discourse-cdn.com/meta/original/4X/b/a/3/ba3cf4a2bc7d936bd3e50a304da01f15fb3befdc.png)

그 이유는: `SiteSetting.max_duplicate_search_index_terms`가 6으로 설정되어 있기 때문입니다… 토픽 본문에는 이런 정도가 괜찮지만, 제목의 경우… 우리는 단순한 1을 원할 것 같습니다.

다음과 같이 수정했습니다:

> <https://github.com/discourse/discourse/pull/21464>
>
> We were giving topics with repeated words extra weight in search index.
> This mea…nt that it was trivial to stuff words into title to dominate in search
> given we search for exact title matches first.
> 
> The following tweak means that:
> 
> \`invite invited invites\`
> and
> \`invite some stuff\`
> 
> Both rank the same for title searching.
> 
> Titles are short and punchy, duplicating words should not give special
> weight.
> 
> Requires a full reindex to take effect.

이것이 반영되면 메타에 전체 재인덱싱을 실행할 것입니다.

---

<div class="post-metadata">

### Author: ![sam](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/sam/32/102149_2.png) [@sam](https://meta.discourse.org/u/sam)
#### Post date: [5월 10, 2023, 9:51오전 UTC](https://meta.discourse.org/t/making-documentation-more-prominent-in-search/263206/11 "2023-05-10T09:51:28Z")

</div>

성공했습니다!

 ![image](https://global.discourse-cdn.com/meta/original/4X/0/7/f/07f99650d65c949fa915e2062ea7307d98383329.png)

@JammyDodger 검색은 지금 어때요?

---

<div class="post-metadata">

### Author: ![JammyDodger](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jammydodger/32/254611_2.png) [@JammyDodger](https://meta.discourse.org/u/JammyDodger)
#### Post date: [5월 10, 2023, 9:55오전 UTC](https://meta.discourse.org/t/making-documentation-more-prominent-in-search/263206/12 "2023-05-10T09:55:19Z")

</div>

정말 훌륭하게 작동하고 있어요. 👏 여러 가지로 속여 보려고 시도해 봤는데, 지금까지 매번 문서가 맨 위에 표시되고 있어요. 👍

---

<div class="post-metadata">

### Author: ![sam](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/sam/32/102149_2.png) [@sam](https://meta.discourse.org/u/sam)
#### Post date: [5월 10, 2023, 9:57오전 UTC](https://meta.discourse.org/t/making-documentation-more-prominent-in-search/263206/13 "2023-05-10T09:57:02Z")

</div>

`poll`에서 작지만 미세한 엣지 케이스가 하나 있는데, 제 새로운 지능을 속일 수 있는 벡터가 있다고 느낍니다. 그 외에는 동의하며, 훌륭해 보입니다.

전체적으로 인덱스를 높이기 위해 검색에 몇 가지 더 개선할 수 있는지 확인해 보겠습니다. 적용하려면 전체 리베이킹이 필요합니다. 1개월 후를 위해 이 내용을 북마크해 두겠습니다.

---

<div class="post-metadata">

### Author: ![thoka](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/thoka/32/115652_2.png) [@thoka](https://meta.discourse.org/u/thoka)
#### Post date: [7월 15, 2023, 6:32오전 UTC](https://meta.discourse.org/t/making-documentation-more-prominent-in-search/263206/14 "2023-07-15T06:32:22Z")

</div>

태그를 사용하여 검색 결과의 랭킹을 개선하는 것(태그에 평가 수정자를 추가하는 것)이 추가적인 세밀한 조정을 가능하게 할지 궁금합니다.
