마크다운 도움말 버튼을 찾기 어렵습니다

며칠 전 이 BBS에 접속해서 이리저리 살펴봤는데,
20230315T135552

포맷팅 규칙을 설명해 주는 마크다운 도움말 버튼을 찾을 수가 없었습니다.

아니, 규칙이 뭔지 묻는 게 아닙니다.
링크를 달라고 하는 것도 아닙니다.
글을 작성하는 사람들이 입력창을 편집하고 있을 때, 바로 입력창 옆에 링크를 제공해야 한다는 겁니다.

음, 괜찮습니다. 아마도 일반 사용자를 위한 문서가 아직 준비가 되지 않은 것일 수도 있겠네요.

2개의 좋아요

컴포저 툴바에는 텍스트를 자동으로 서식 지정하고, 마크다운(추가하려는 내용에 따라 일부 BBCode 포함)을 수동으로 입력할 경우 어떻게 동작하는지 미리 보여 주는 옵션이 포함되어 있습니다. 이렇게 미리 확인하는 것이, 작성 중인 메시지 밖의 문서로 이동시키는 링크보다 더 유용하지 않나요?

2개의 좋아요

네. 다음과 같은 경우를 생각해 보세요. 사용자가 "

이 아닌

"이라고 말하고 싶어 할 때 말이죠.
결국 그는 "
https://www.openstreetmap.org/, 이 아닌
https://www.openstreetmap.org/edit
"처럼 보이게 하는 올바른 방법을 스스로 발견하게 됩니다.
하지만 만약 그가 혼자서 직접 알아내야만 하는 상황이 아니었다면, 그 방법을 알아낼 수 있는 방법은 전혀 없었을 것입니다. 왜냐하면 편집기 안에서는 그것이 큰 미스터리이며, 문서화가 전혀 없기 때문입니다. 정말로 전혀요.

2개의 좋아요

저는 GitHub에서 이 파란색 링크와 같은 링크가 필요하다고 말하는 거예요.

2개의 좋아요

사용자를 다루는 방식이 꽤 흥미롭네요. 'I’를 의미할 때마다 항상 ‘he’ 또는 'you’를 사용하고 계시죠. 그냥 말씀드립니다.

웹에서는 서비스 내에서 콘텐츠를 생성할 때 세 가지 종류의 편집기가 있습니다:

  • WordPress, Drupal 등 CMS 스타일: 버튼이 아주 많습니다 (음, WordPress는 자신들의 편집기를 망가뜨리려고 모든 노력을 기울이고 있지만, 그것은 별개의 이야기입니다)
  • Facebook, Twitter 등 미니멀리스트 소셜 미디어(SoMe): 버튼이 없거나 아주 적습니다
  • 고전적인 개발자 세계: 대부분 정적 사이트 생성기 등이며, 여기에는 Discourse도 포함됩니다

첫 번째 그룹은 웹 이전부터 오피스 패키지가 우리에게 가르쳐준 것과 같은 로직을 사용하려고 합니다. 모든 사람이 버튼이 무엇을 하는지, 또는 단축키가 무엇인지 알아야 하므로 실제 도움말 버튼은 없습니다. 그리고 사용자가 모른다면 그 정보를 스스로 찾아야 합니다.

소셜 미디어는 평범한 여성과 남성(average Jane and Joe)이 그런 버튼을 필요로 하지 않는다는 것을 이해했습니다. 그들은 그런 버튼을 사용하지 않기 때문이죠 — 그리고 모바일에서는 공간 자체가 부족합니다. 또한 필요하지 않으므로 도움말 버튼도 없습니다.

개발자 기반 서비스는 마크업을 보고 하지 않아도 할 줄 아는, 대량의 코드를 기억하는, 그리고 손이 키보드에서 떨어지기를 원하지 않는 사람들을 위해 서비스를 제공합니다. 또한 모든 사람이 문서를 읽고 예를 들어 표를 만드는 방법을 외워야 하므로 도움말 버튼은 없습니다.

하지만 사용자는 다양합니다. 제 포럼에서는 일반인들이 일상적인 주제에 대해 이야기하며, 대부분 기술 수준이 낮습니다. 여기서 Development 채널이나 GitHub에서는 완전히 다른 요구 사항이 있으며, 모든 사람이 매우 높은 기술력을 가진다고 가정합니다. 또한 생성되는 콘텐츠도 완전히 다릅니다. 저는 글쓰기 자체가 주목받는 한 사이트의 회원이기도 합니다. 그곳에서는 또다시 완전히 다른 요구 사항이 있습니다.

UX의 문제는 도구 상자에 도움말 버튼을 두는 것이 아닙니다. 아무도 그것을 사용하지 않습니다. 생성하고 사용하기가 불가능하기 때문이죠. 그리고 GitHub 스타일의 링크조차도 너무 많습니다. 그것은 거의 사용되지 않는 완전히 무관한 구성 요소이며, 모든 사람은 문서와 매뉴얼이 어디에 있는지 알고 있습니다.

진정한 UX/UI 솔루션은 다음 능력을 부여하는 것입니다:

  • 관리자가 사용자를 위한 기본값을 생성할 수 있도록 하기
  • 사용자가 기본값을 변경할 수 있도록 하기

그리고 사용자 대다수가 실제로 필요로 하며, 현재 부족한 것은 그 툴바를 숨기는 방법입니다. 그것은 편집할 수 있는 능력보다 더 중요할 것입니다.

편집기 문제는 여기서 거의 FAQ 수준의 주제이며, 도움말 버튼은 그 일부일 뿐입니다. 그리고 다시 한번 솔직해지겠습니다. Dan에게는 그의 의제가 있으며, 도움말 버튼은 그 의제의 또 다른 징표이지 목표가 아닙니다. Dan이 실제로 말하려는 것이 무엇인지, 그는 어떻게 해야 하는지 몰랐고 그에 대한 도움을 찾지 못했다는 것이기를 바랍니다. 그것은 해당 사이트의 문제가 되어야 하며, 플랫폼으로서의 Discourse 자체의 문제는 아닙니다.

2개의 좋아요

네, 제가 말씀드린 것은 실제 사례입니다. 제가 이 링크에 게시물을 올렸을 때

두 개의 링크 미리보기가 동일하게 표시되어 제 게시물이 어색해 보이더라고요.
그래서 저는 (Discourse) 인터페이스와 씨름하며 그 마법 같은 기능을 비활성화하는 방법을 찾아보려 했습니다. 하지만 어떻게 하면 되는지에 대한 문서가 없었죠.

결국 모든 것이 시행착오의 연속이었습니다…

그런 다음 저는 이렇게 실험해 보았습니다.

https://www.openstreetmap.org/ .
https://www.openstreetmap.org/edit .

이렇게 하면 다음과 같은 기이한 조합이 생성됩니다.

https://www.openstreetmap.org/ .
OpenStreetMap .

네, 그 나름의 논리는 있지만, 그게 제 의도는 아니었습니다.
여전히 제가 다른 사용자에게 보여주고 싶었던 모습과는 달랐습니다.

이쯤 되자 "수 시간의 시행착오 대신 공식 문서를 찾아볼까"라는 생각이 들었습니다.
좋습니다, 그래서 찾아보고 또 찾아보다가 Formatting posts using markdown, BBCode, and HTML 를 발견했습니다.

좋습니다, 거기에는
[url]http://bettercallsaul.com[/url]
형식이 언급되어 있었지만,

[url]https://www.openstreetmap.org/[/url]
[url]https://www.openstreetmap.org/edit[/url]

으로 시도해 보니 작동하지 않았습니다:
https://www.openstreetmap.org/
https://www.openstreetmap.org/edit
따라서 Formatting posts using markdown, BBCode, and HTML 는 아마도 최신 정보가 아닐 가능성이 높습니다.

그렇다면 저는 마침내 어떻게 제 문제를 해결했을까요?

[https://www.openstreetmap.org/](https://www.openstreetmap.org/), not
[https://www.openstreetmap.org/edit](https://www.openstreetmap.org/edit)

을 사용하여
https://www.openstreetmap.org/, not
https://www.openstreetmap.org/edit
을 얻었습니다.
음, 여러분이 "Markdown"을 사용한다는 것을 기억했고, Markdown에는 그런 구문이 있다는 것도 기억나서 시도해 보았더니 작동했습니다.

제가
말하고
싶은
것은
사용자가 이 문자나 저 문자를 입력했을 때 어떤 일이 일어나는지 알려주는 공식 문서가 어딘가에 있어야 한다는 것입니다.
소스 코드를 읽어야만 알 수 있을 정도는 아니어야 합니다. 감사합니다.

좋습니다, 그럼 FAQ에 넣어두시고, 인터페이스 어딘가에 그 FAQ로 링크를 걸어두세요.

좋습니다, Discourse 웹사이트에 향후 포맷팅 FAQ를 올려두었다고 가정해 보죠. 문제는 해결된 것 같습니다…
하지만 사용자가 자신이 Discourse를 사용한다는 것을 어떻게 알 수 있을까요? 네, 저는 관리자而不是 사용자가 아니라 일반 사용자에 대해 이야기하고 있습니다. 다시 한번 감사합니다.

2개의 좋아요

참고로, 작성기에 도움을 줄 수 있는 버튼이 있습니다:

위쪽 칸에 URL을, 아래 칸에 표시할 텍스트를 입력하면 마크다운 형식으로 자동 변환해 줍니다. :+1:

5개의 좋아요

이것은 과장된 주장입니다. 포맷팅 규칙을 외워 문서가 필요 없는 소수의 열성적인 개발자들도 있을 수 있지만, 초보자가 아닌 모든 사용자가 포맷팅 규칙을 모두 외우고 있는 것은 아닙니다.

Discourse의 다양한 인스턴스가 지원하는 마크다운, BBCode, HTML의 다양한 변형(flavor)들이 있기 때문에, 문서에 그러한 매뉴얼이 존재하지 않습니다.

만약 누군가가 특정 사이트에서 유효한 마크업 코드 집합에 대한 매뉴얼을 작성하고, 아래 그림과 같이 composer 페이지에 GitHub 스타일의 도움말 링크를 추가하고 싶다면, 어떻게 해야 할까요?

이것이 존재하는 것을 확인했습니다:

2개의 좋아요

Do we need a help button on the composer? 를 참고하여 닫음