Kodokon kodokon.com

Задать вопрос, на который ответят

Структурируй просьбы о помощи, чтобы получать быстрые ответы, и познакомься с минимальным воспроизводимым примером.

7 мин · 3 вопросов

Открыть этот урок в Kodokon

Просить о помощи - не признание слабости: это делают все и каждый день, включая самых опытных. А вот плохо заданный вопрос часто остаётся без ответа, и вовсе не из вредности. «Не работает, помогите» просто не содержит ни одной пригодной информации: никто не может угадать твой код, твою систему и то, что ты уже пробовал.

У хорошего вопроса пять составляющих. Чего ты хочешь добиться - одной фразой. Что ты сделал - вместе с нужным куском кода. Какого результата ты ждал. Что происходит на самом деле - с точно скопированным сообщением об ошибке. И что ты уже пробовал, чтобы тебе трижды не предложили одно и то же. Добавь своё окружение: система, язык и версия.

TEXT
Цель: показать список статей на моей странице.
Контекст: Python 3.12 на Windows 11.
Код: (небольшой фрагмент, который вызывает проблему)
Ожидал: появятся 3 заголовка.
Получил: TypeError: 'NoneType' object is not iterable
Уже пробовал: проверил имя файла, добавил print.
Шаблон вопроса, который можно скопировать: шести строк достаточно.

Лучший инструмент, чтобы получить помощь, называется минимальный воспроизводимый пример. Идея такая: сократи свой код до самого маленького куска, который всё ещё воспроизводит проблему. Ты убираешь всё, что к делу не относится, строку за строкой, пока не останется только суть. У этого усилия есть неожиданный побочный эффект: очень часто ты сам находишь причину по дороге, ещё до того, как задал вопрос.

И последнее, о чём часто забывают: когда тебе помогли, скажи спасибо и напиши, что именно сработало. Хорошо заданный и хорошо закрытый вопрос становится ответом для сотни людей, которые столкнутся с тем же после тебя. Именно так работает всё сообщество, в которое ты только что вошёл, и ты уже его часть.

Проверка знаний

Убедись, что запомнил ключевые моменты этого урока.

  1. Почему вопрос вроде «не работает, помогите» остаётся без ответа?
    • Потому что его считают слишком фамильярным
    • Потому что он не содержит ни одной пригодной информации
    • Потому что за ответ всегда нужно платить
  2. Почему код стоит вставлять текстом, а не скриншотом?
    • Чтобы его можно было скопировать, запустить и найти поиском
    • Потому что изображения запрещены на форумах
    • Потому что текст отображается быстрее
  3. Что такое минимальный воспроизводимый пример?
    • Весь проект, упакованный в архив
    • Самый маленький кусок кода, который всё ещё воспроизводит проблему
    • Описание проблемы вообще без кода
    • Скриншот полной ошибки