Do we need a help button on the composer?

A help button could be useful either way

15개의 좋아요

We had this button on Stack Overflow and the analytics / data showed that almost nobody used it. That does not mean it should not exist, of course, but the general rule is that the type of people you would want to use this button, pretty much never do.

4개의 좋아요

Stack Overflow seems way more aggressive these days for brand new users and audience for Discourse is way wider so this kind of approach may be applicable

I think there is definite value in giving some extra tips for tl0/tl1 that are getting accustomed and also for more advanced users that are looking for secret magic.

I guess what I want a little is a help mode that goes away after a bit

6개의 좋아요

To be fair, there is a plugin that sort of permits this already and I don’t think a lot of people use it…
https://github.com/cpradio/discourse-plugin-composer-help-button

Granted, it isn’t right aligned, but it gives people a way to add customize help for the format bar should they deem that a necessity.

7개의 좋아요

Also, this was written before the new outlet (that Canned Replies uses) to display help text at. So it could be improved to use that same location instead of a modal now (if someone has the time PR welcome).

Right-aligning the button might require a new outlet or a new option to the toolbar component (PR welcome for that too).

But those would be the only necessary improvements to make it meet the UI mock ups above.

3개의 좋아요

None of that is new; I worked with Ben to add that in 2010/2011. See proof here…

4개의 좋아요

Yeah it fealt eerily familiar. I guess I think there is merit for a help mode that kicks out once you posted a bit

But sure this can be plugin territory, agree that for seasoned users a help button is largely noise

2개의 좋아요

For what it’s worth, I appreciate the comfort of being able to find some kind of formatting help, even if it’s rarely used.

It’s good for bootstrapping new users unfamiliar with markdown (like communities coming from more bb related forms, or with wysiwyg editors), and a nice reminder for when I just can’t figure out how how to do something simple like code formatting, and have been deep in JIRA or Sharepoint or something with vastly different formatting options.

7개의 좋아요

This is nice as well

14개의 좋아요

비슷한 요청에 대한 더 최근의 게시물을 크로스포스팅합니다 - Hard to find the Markdown help button

3개의 좋아요

이 문제에 대한 제 의견은 다음과 같습니다.

경험이 적은 사용자들은 마크다운 기능을 어떻게 사용해야 하는지 잘 모릅니다.

마크다운 도움말을 제공하면 초보자 사용자들이 마크다운을 배우기 쉬워질 것입니다. 다른 사용자들도 마크다운 도움말에 관한 내용을 게시한 바 있습니다. 접근성을 높이는 데 도움이 될 것이므로 이 기능이 유용할 것이라고 생각합니다.

대안으로, 초보자를 위해 상단에 마크다운 버튼을 더 추가할 수도 있습니다. 그러나 그렇게 하면 레이아웃이 더 혼란스러워진다는 문제가 있습니다.

2개의 좋아요

제프가 위에서 언급한 대로, 이 섹션(툴바)을 New User Tips 에도 추가하는 것이 좋은 아이디어라고 생각합니다. :slightly_smiling_face:

간단한 설명과 설정 가능한 링크를 포함할 수 있습니다. 이 링크는 포맷팅에 대한 별도 주제인 Understanding Discourse for new users 으로 연결되거나, 마크다운 도움말인 Markdown Reference 으로 직접 연결될 수 있습니다.

4개의 좋아요

사용자가 보는 것은 다음과 같습니다:

여기에 입력하세요. Markdown, BBCode 또는 HTML을 사용하여 서식을 지정할 수 있습니다.

사용자는 Markdown, BBCode 또는 HTML을 사용하지만 일부 기능이 작동하지 않는 것을 발견합니다.
또한 다른 사용자가 사용하면서 작동하는 기능이 있지만, 자신은 그 사실을 알지 못하는 경우도 있습니다.

즉, Markdown, BBCode 또는 HTML에는 서로 다른 버전이 존재합니다.

따라서 도움말에서 Discourse가 어떤 버전을 사용하는지 명시해야 합니다.

또는 그 대신, Discourse가 사용하는 마크업 항목의 전체 목록을 제공하면 됩니다.

아니면 최소한 소스 코드에서 해당 기능이 어디에 있는지 링크를 제공해야 합니다.

하지만 일반 사용자는 그 소스 코드를 이해할 수 없습니다.

따라서 여전히 전체 목록을 제공하거나, 이를 '치트시트(cheatsheet)'라고 부르며 Discourse에서 구현된 마크업 연산자 목록을 제공하는 것이 더 나을 것입니다.

2개의 좋아요

그렇다면 [details=요약][/details] 구문은 어디에 문서화되어 있나요?

  • 이는 사용자 정의 Discourse 기능이기 때문에 위에서 언급한 페이지 어디에도 언급되지 않습니다.
  • 메타에서 "[details]"로 검색하면 존재한다는 것을 알 수 있으며, "숨기기"로 설명될 수 있지만 요약 구문이 어떻게 작동하는지에 대한 힌트는 제공하지 않습니다.
  • 웹 검색을 하면 discourse-details 저장소를 찾을 수 있지만, 여기에는 이제 *“플러그인이 비활성화되었으며, 이제 기본적으로 Discourse에 포함됩니다”*라는 정보만 포함되어 있습니다.
  • 마침내 https://meta.discourse.org/t/details-in-topic-styling-changes-feedback/285364에서 찾았습니다. 사용자가 구문을 배우기 위해 보내기에는 기대하기 어려운 위치입니다.

종류의 공식 문서로 연결되는 도움말 버튼이 정말 있었으면 좋았을 텐데…

이것은 discobot 튜토리얼의 일부입니다.

1개의 좋아요

기어 아이콘을 클릭하면 자동으로 삽입해 주겠다고 제안합니다.

기어 아이콘을 클릭하지 않는 사람들은 아마도 도움말 아이콘도 클릭하지 않을 겁니다. :winking_face_with_tongue:

1개의 좋아요

디스코봇 튜토리얼이 있나요? 저는 수년간 디스커스를 사용하며 그 사용을 장려해 왔지만, 이 튜토리얼이나 디스커스 사용법을 배울 곳은 여기라는 생각을 한 번도 해본 적이 없습니다. 지금도 (저희 디스커스 인스턴스를 보고) 어떻게 이걸 실행해야 하는지 전혀 모르겠습니다.

무언가를 놓치고 있는 건지, 아니면 제가 처음 디스커스를 사용하기 전에 디스코봇이 도입된 건지 싶어서 https://meta.discourse.org/t/discourse-new-user-guide/96331을 방문했습니다. 하지만 디스코봇 튜토리얼이나 [details] 태그에 대한 언급은 없었습니다. https://commonmark.org/help/tutorial/은 있지만, 이는 커먼마크(CommonMark)에 한해 적용됩니다.

@pfaffman 저는 이제 기어 아이콘 아래에 해당 옵션이 있다는 것을 확인했습니다. 기어 아이콘을 클릭하지 않았던 것이 아니라, 기어 아이콘이 설정 변경을 위한 것인 줄 알고 있었기 때문입니다. (제 생각이 틀렸습니다.) 또한 [details]와 같은 디스커스 전용 기능이 꽤 많을 것이라는 가정과 결합되어, 그런 기능들이 숨겨진 메뉴 아래에 모두 나열되어 있을 리가 없다는 확신이 들어 매뉴얼을 찾아보게 되었습니다.

만약 버튼 중 하나가 명확하게 도움말용(예: 물음표)이었다면 분명히 클릭했을 것입니다. 삽입용 버튼이 명확했다면 그 것도 클릭했을 것입니다. 저는 단순히 무의식적으로 그것이 기어 아이콘일 수는 없다고 스스로를 설득하고 있었던 것입니다…

아마도 저는 구식 사고방식을 가진 사람일 수 있지만, 모든 기능을 배우고 향후 참조할 수 있는 권위 있는 출처가 정말로 필요합니다. 그런 것이 존재하는지, 아니면 봇을 통한 학습이 새로운 트렌드인가요?

1개의 좋아요

Discourse 사이트에 새 계정을 생성하세요.

Discobot 사용자 정의

여기서 공지사항을 꾸준히 확인하는 것 외에 다른 방법은 없습니다. https://meta.discourse.org/docs의 문서에서 내용을 문서화하려는 노력이 증가하고 있지만, 그것이 권위 있는 출처로 느껴지는지는 잘 모르겠습니다.

감사합니다. 그래서 새 계정을 만들면 실제로 discobot이 보인다는 것을 확인했습니다. 하지만 discobot이 시작되기 전에 가입한 저 같은 사용자에게는 discobot과 어떻게 상호작용해야 하는지 매우 혼란스럽습니다. 이건 아마도 약간 주제에서 벗어난 이야기일 수 있지만, 도움말 버튼이 필요할 수 있는 잠재적 요구 사항을 보여주기 때문에 이 곳에서 논의를 계속하겠습니다. 적절하다고 생각하시면 내용을 이동하거나 더 적합한 주제로 안내해 주시면 됩니다.

discobot을 처음 발견한 후, 우리 사이트에서 사용해보려고 했습니다. 여러 토론과 언급에 따르면 어딘가에 @discobot start tutorial을 입력하면 무언가를 배울 수 있을 것이라고 기대했습니다…

  • 한 사이트의 사이트 채팅에서 이렇게 시도해 보았습니다. 아무 반응이 없었습니다. @discobot과 개인 채팅을 시작하려고 했지만 찾을 수 없었습니다.
  • 그 다음 discobot에게 "개인 채팅"을 보내려고 했습니다. 하지만 보내지 못했습니다.
  • 우리 사이트 중 하나에서는 discobot을 개인 채팅 목록에 추가할 수 있었지만, "start tutorial"을 요청해도 아무 일이 일어나지 않았습니다.
  • 마지막으로 이 사이트에 새 계정을 만들었고, 봇이 반겨주었습니다. 봇과의 상호작용이 있는 토픽이 있어야 한다는 것(그리고 이 토픽을 북마크해야 한다는 것)이 명확해졌습니다.

이제 우리 사이트에서 discobot을 검색하고, 사용자 페이지로 가서 메시지를 보낼 수 있다는 것을 알게 되었습니다. 하지만 이때는 혼란스럽게도 긴 제목과 내용을 입력해야 합니다. 마침내 이 메시지가 생성된 후, "start tutorial"을 요청할 수 있습니다.

왜 이렇게 어려운가요? 봇이 채팅이나 개인 채팅 등에서 튜토리얼 시작 요청에 반응하지 않는 이유는 무엇인가요? 사이트에 새로 가입한 사용자가 알림 설정을 건너뛰고 discobot을 눈치채지 못하면 어떻게 되나요? 나중에 도움을 받는 방법은 무엇인가요?

최선의 해결책이 무엇인지 모르지만, 이 과정을 안내해 주는 도움말 버튼이 어딘가에 있었다면 매우 유용했을 것입니다.

1개의 좋아요

설정에서 Discobot을 비활성화하셨나요? 아주 오래된 Discourse 버전을 사용 중이신가요?

1개의 좋아요