Все дело в том, что авторы таких гайдов редко подстраиваются под реальных новичков
Популярный пост в соцсетях описал, как начинающие разработчики читают технические инструкции разработчиков. Материал попал в самое сердце многих пользователей.
Инструкции с пометкой «простой гайд для новичков» часто оказываются квестом уровня «попробуй объяснить бабушке, как работает нейросеть». С непонятными терминами, шагами, пропущенными зависимостями и волшебными строками кода, которые «просто нужно вставить в Терминал».
Сначала вы запускаете Терминал и просто выполняете команду ajkl;gawgor;iqeg;iJLkqen. Потом идете в папку library/library/library/llibrary/liiiiiibrarrrary/llllliiiiibrary/hidden/hidden/hiding/you can’t find me…Annieавтор поста
К финалу автор доходит до заветного «Boop!» — метафоры магического момента, когда все вдруг начинает работать. Правда, путь до него оказывается настоящим марафоном с 193 Google-запросами, переполненной RAM и потерей самооценки.
Гайды не для тех, кто в первый раз
Автор подчеркивает, что уважает и благодарен тем, кто пишет туториалы. Но обращает внимание: большинство из них пишется с предположением, что читатель уже в теме, знает, как работает Терминал, что такое env и где искать .config на macOS.
Google запустила тестирование «убийцы» Sora от OpenAI. Насколько ее генерации лучше?tproger.ru
В результате:
- «Простой трехшаговый гайд» занимает несколько часов.
- Пользователь оказывается в логической ловушке: чтобы понять туториал, нужно уже уметь делать то, чему он должен научить.
- Самые важные шаги часто опущены или неочевидны.
Реакция комьюнити: боль, смех и самопознание
Пост быстро разошелся по Reddit, Hacker News и X, где сотни пользователей делились похожими историями:
Я искал, как установить Pandas. Через 40 минут у меня был TensorFlow, Node.js и экзистенциальный кризис.
Каждый гайд заканчивается словами «все, теперь просто откройте Snarfus», а я сижу и думаю, кто такой вообще этот Snarfus?
Как делать гайды понятнее?
Несколько очевидных (но часто игнорируемых) советов авторам туториалов:
- Объясняйте, зачем делается каждый шаг. Не только «что», но и «почему».
- Проверяйте инструкции на чистой системе. Не у всех установлен Node 18, Homebrew и 19 глобальных пакетов.
- Избегайте внутреннего жаргона. Даже если вам кажется, что «shamrock portal» — общепринятый термин.
- Уточняйте зависимости и платформу. Команда, работающая на Ubuntu, может не работать на Windows.
- Добавляйте скриншоты. Иногда визуальный шаг говорит больше, чем 10 строк текста.