I’ve been onboarding new users onto our Discourse site and taking note of how they are interacting and where they get tripped up.
One big pain point I noticed was that new users easily miss that a preview of their post is being generated to the right of the compose window because it’s completely covered up by the educational / yellow panel.
[Image Description: Screenshot of situation decribed above.]
For people new to markdown, something like 
or
[Write How We Communicate FAQ](https://hub.youthpowercoalition.org/t/write-how-we-communicate-faq/451/2)
especially when copied in from a different text, looks really odd and not intuitively like it would work because the preview isn’t showing. My new user copied something in and then immediately started editing out things like the * in *bolded text* . She never clicked esc in order to dismiss the help text and then discover that the odd characters actually resulted in the post that she wanted.
So, from a UX perspective, I think there should be something that makes it obvious that a preview IS being generated and the help text is dismissable. It’s not obvious enough right now.
Tagging in @tobiaseigen because we started this conversation outside of Meta.
This was Tobias’s initial response
I did not realize that it does not go away by itself because I always immediately use the X to close it. If people do not realize it can be closed and don’t close it, then indeed the composer functionality is going to be super confusing and hard to use. If you could add a reply to How to disable the yellow panels for first two posts? with this feedback, we can work on improving it. One thought I have is to have a close button on the popup, and to disallow typing until it is selected? Or to close it automatically after a little while?
Maybe a little transparency for the panel background?
I would also place (another?) Esc x button on the left side of the panel, the one on the right side, usual location, is really far from the “eye action”
[Image Description: Screenshot from article that shows what I described above]
I wonder about this because I think there are a lot of places that put x’s on the upper right side. What I’d like is for the x and the esc shortcut to be a much darker color and for the x to match that x in a circle icon that I’ve come to expect. See the article above.
Well you’re right, it’s objectively not a big deal, but I can testify that in some rare case where users are really not used to… any ui at all, everything is a mountain on the road to actually write something. The very subtlety of discourse that we all love can be perceived as frightening. I know my case is fringe but I had to convince some of my users to go from pen and paper directly to discourse without passing go! So yes, the panel was a (small) friction.
I think a two parts composer is a concept difficult (relatively of course) enough to apprehended, the panel “murks” a little bit the first impression (by hiding only the part on the right, for a short time, I agree).
Oh yes about that I’ve always thought it was weird that I still see this panel, as an admin, after hundreds of posts and topics, but it never bothered me that much…
but I’ve just checked, the summary says I’ve created -313 messages ! A negative count ?
We’re a small team at the moment and currently redesigning our forum, hence the 1:1 onboarding/user tests, so I’m not worried about our current users.
I think you’re underestimating how big a deal friction is for new users, though, especially for communities that exist only via a forum. Markdown can look very intimidating to people. I’m super tech savvy and I still rely heavily on the preview pane to know that I’m on the right track. People who are scared away from ever posting, well, of course they wouldn’t show up as users who post more than twice.
I changed my mind. I think it’s definitely worth trying if moving the x and esc to the left changes things for users. And, I’ve since noticed it on the left side for a lot more websites than I anticipated.
The other thing you could do is turn this message off entirely; then new users would only see the preview. I believe that’s possible today via existing Discourse site settings.
من الواضح بشكل معقول كيفية إغلاق اللوحة. لكن المشكلة ليست أن المستخدم يحاول إغلاق اللوحة ولا يمكنه معرفة كيفية القيام بذلك. بدلاً من ذلك ، لا يرى المستخدم سببًا لإغلاقها لأنه لا يعرف أن هناك شيئًا مثيرًا للاهتمام يختبئ خلفها. ثم يشعرون بالإرهاق من تحرير صيغة markdown بدون معاينة ،
أعتقد أن هذه عقبة محتملة للمستخدمين غير المألوفين بمحررات markdown ، وأول مشاركات قليلة هي بالضبط عندما تكون قابلية تعلم واجهة المستخدم مهمة للغاية.
من الممكن أن نقوم بعمل لوحة تعليمية “في الوقت المناسب” عند أول مرة يرى فيها المستخدم المحرر. ولكن بعد ذلك، هذه هي نقطة هذه اللوحة.. هناك بالفعل تعليم “في الوقت المناسب” يحدث هنا، لتثقيف الناس حول التحلي باللباقة عند المشاركة عندما يبدأون في كتابة أول رد لهم:
النقد البناء مرحب به، ولكن انتقد الأفكار، وليس الأشخاص
للمزيد، راجع إرشادات مجتمعنا. ستظهر هذه اللوحة فقط لأول مشاركتين لك
هذه.. نصيحة مهمة جدًا. بعض من أهم النصائح التي نقدمها. الآن، يجب تخطي لوحة النصائح هذه إذا أشرت إلى “تخطي محتوى المستخدمين الجدد” أثناء الإعداد الأولي، هكذا – تم تقديم هذا الإعداد في Discourse 2.6 في أواخر عام 2020:
ومع ذلك، لا أشعر أن كتابة الكلمات، كما أفعل هنا، تتطلب عادةً الكثير من التنسيق (أو أي تنسيق؟)، والناس بشكل عام مرتاحون لكتابة الكلمات في مربعات على الإنترنت هذه الأيام، بعد 30 عامًا.
(في الواقع، “التنسيق” الرئيسي في معظم المشاركات هو إضافة الصور، وهو أمر يفعله الأشخاص العاديون على هواتفهم وأجهزتهم كل يوم؛ أفترض أن الغالبية العظمى من العالم تفهم كيفية القيام بذلك، عن طريق الضغط على زر “إضافة صورة” في شريط الأدوات أو المحرر.)
حسنًا، لقد أتيت للتو من موقع Discourse تم تنفيذه حديثًا ليحل محل موقعين قديمين. ما زلنا نقوم بضبطه وأحد أول الأشياء التي صادفتها هو عدم العثور على معاينة. أعني، كل موقع معقول لنشر النصوص لديه نوع من المعاينة وكنت أبحث بجنون عن زر للكشف عنها. أجرؤ على القول إنني مستخدم منتديات متمرس، لكن الأمر استغرق مني دقائق للتفكير في إغلاق اللوحات الصفراء والزرقاء اللاحقة (المواضيع المشابهة).
غالبًا ما يكون لدينا مستخدمون يلصقون أجزاء طويلة من التعليمات البرمجية أو عناوين URL غير منسقة. هناك حاجة إلى معاينة بالفعل وخاصة للمستخدمين لأول مرة. يرجى التعامل مع هذا كتعليقات من المستخدم وليس مجرد فكرة غامضة.
حل (أعتقد أنه) سهل هو مجرد تضييق لوحة الترحيب إلى ثلثي عرضها لجعل جزء المعاينة الأساسي مرئيًا. عندها يصبح من الواضح أن إغلاق اللوحة سيحقق شيئًا ما.