Поскольку на нашем форуме пользователи часто публикуют логи или другой вывод консоли, а новички нередко используют форматирование цитат вместо предварительно отформатированного текста или вообще не применяют форматирование, было бы очень полезно добавить в туториал для новых пользователей введение в форматирование предварительно отформатированного текста.
Я уже изучил указанные выше тексты инструкций, но простое добавление инструкций по предварительно отформатированному тексту кажется мне неправильным, поскольку Discobot действительно должен проверять, правильно ли пользователь применил форматирование (а сейчас этого не делает).
Как можно добавить инструкции по предварительно отформатированному тексту в туториал для новых пользователей Discobot, при этом чтобы Discobot действительно проверял правильность форматирования?
Я рекомендую перейти в /admin/customize/site_texts/, найти js.composer.reply_placeholder (или Введите здесь. Используйте Markdown, BBCode или HTML для форматирования.) и изменить этот текст на что-то вроде:
Введите здесь. Используйте Markdown, BBCode или HTML для форматирования. Перетащите или вставьте изображения. Оберните блоки кода символами ```.
В любом случае, слишком мало людей будут проходить учебное пособие. Есть небольшой шанс, что они обратят внимание на этот плейсхолдер, но большинство всё равно просто вставит содержимое слепо.
Я сначала так же подумал, но, как я писал выше: тогда не будет проверки, действительно ли пользователь применил форматирование предварительно отформатированного текста. Он мог бы просто полностью пропустить это и всё равно получить ответ «Отличная работа!».
Не в нашем форуме: 14 из 27 новых пользователей за последние 14 дней прошли полностью весь туториал.
Это неплохая идея, но на самом деле в необходимости форматирования кода возникает довольно редко — есть ли это в продвинутом руководстве? Мне кажется, что именно там это и должно быть.
Мне также очень нравится предложение @pfaffman по редактированию текста-заполнителя по умолчанию.
В конечном итоге вам, возможно, придётся поступить так, как мы в итоге поступили на Stack Overflow: попытаться обнаружить код, который был вставлен без форматирования, и отклонить ответ, если вы видите слишком много «похожего на код» текста в посте — здесь, на meta, идёт обсуждение плагина для этого.
Форматирование кода — это очень базовая операция, которую наши пользователи должны знать с первого дня. Поэтому на нашем форуме это не должно быть в продвинутом руководстве, а должно находиться в базовом.