Comments 97
Ну спасибо, конечно. Выяснилось, что в ometer 2.6.217 eveningly этапы 1-4 полностью ломают комбулятор пролакса. К счастью, додумался предварительно сохранить овербут в пчулей. Куда смотрят мейнкунеры проекта, совершенно непонятно.
оо, еще одна проблема разработчика который он ОБЯЗАН решать)
по классике:
Раньше миром управляли умные. Это было жестоко.
Умные заставляли тупых учиться. Тупым было тяжело.
Теперь миром управляют тупые. Это честно, потому что тупых гораздо больше.
Теперь умные учатся говорить так, чтоб тупым было понятно.
Если тупой что-то не понял - это проблема умного.
Раньше страдали тупые. Теперь страдают умные.
Страданий стало меньше, потому что умных становится всё меньше и меньше
Я согласен еще когда документации нет и возитесь сами, но когда уже есть пошаговое руководство - что еще надо?
Пошаговое руководство которое не объясняет, что происходит на каждом шаге это просто набор заклинаний, оно учит не понимать, а слепо копипастить. Ценность такого обучения нулевая, а при малейшем отклонении от инструкции (другая версия, другая ОС) все разваливается
Подобного рода "руководства" пишутся обычно кем-то, кто долго копался и решил свою проблему, решив при этом поделиться с другими, кому это может помочь.
Да, конечно, было-бы хорошо что-бы при этом человек написал развернуто, с подробными объяснениями, но это будет уже не формат краткой справки, а скорее формат книги, что требует сильно больше времени и мотивации это делать.
Как правильно пишет @Chillingwilliкаментом выше, это просто магические заклинания, из которых не возникает (в принципе не может возникнуть) понимание того, что (как и зачем) они делают. Очень похоже на Linux на десктопе - по большинству вопросов, а таких вопросов у вас будет бесконечно много, вы сможете нагуглить ответ в виде таких заклинаний, не понимая, что и как они делают, просто надеясь на то, что это сработает. Если у вас не сработало - вы в беде, единственный выход из которой называется Windows, и который сегодня дорос уже до версии 11. Понятно, что никто не обязан писать адекватную справку на свой pet-проект и его взаимодействие с ОС, но что такая справка, как бы это сказать, желательна - надеюсь, вы спорить не станете, ведь иначе потенциально очень даже ценный софт становится фактически бесполезным и непригодным к использованию только лишь из-за непонимания среднестатистического пользователя как это установить и как с этим работать.
Если у вас не сработало - вы в беде, единственный выход из которой называется Windows
Там тоже придётся гуглить заклинания. Хотя, как и в случае с Linux - можно покопаться, чтобы понять - что эти заклинания означают.
Вы можете нагуглить ответ в виде инструкции, но если вы хотите разобраться в сути проблемы, то вы можете нагуглить массу разной информации, вплоть до исходников изучив которые вы получите исчерпывающие ответы.
В чем тут разница с Виндой? Там вы найдете такие-же "скрижали", которые не факт что подойдут к вашей версии операционки (даже при совпадающем номере), и уж точно вы хрен найдете исходники.
Прям классическое - а что тебе еще собака надо?)
Ты пришел в поиске решения проблемы - заклинание решает твою проблему.
Хочется разобраться - гугл и доки в твоем распоряжении (в 99% случаев все cli-заклинания имеют справку). Не работает, то же самое, просто заклинание узкое, надо разобраться и подогнать под свою ситуацию
Как же блин бесит что в современном мире ты ОБЯЗАН разбираться во всем, даже банально продуктов купить и то приходится разбираться, про сложные дорогие вещи, где навар выше от наеба я вообще молчу.
С чего вы взяли что у разработчика есть цель кого-то чему-то обучать.
Мне почему-то кажется, что разработчик зачастую производит продукт, которым хотят пользоваться и за потребление этого продукта разработчику будет поступать доход. Чем меньше потребителей поймут как сим творением пользоваться, тем беднее будет разработчик.
А в целом да, когда пишешь на отвали, нафига заморачиваться и писать какую-либо инструкцию?! Это лишнее время! И так сойдёт.
Приходит погромист к врачу.
П: "Дратути док, у меня болит рука, нога, голова и жопа!"
В: "Попей таблеток."
П: "Каких таблеток?"
В: "Сам разберешься, ты же умный. Документация на таблетки есть, в инете найдешь."
PS. Комент написан нейросетью, потому что ровные мясные пацаны текст не форматируют и опечатки не исправляют.
Это не анекдот. Иногда так и приходится поступать, когда в поликлинике арбидол прописывают, вместо реальных препаратов.
Реально приходится изучать что прописали, уже не раз сталкивался что прописывают нормальный препарра, и плюс к нему какой-либо плацебо БАД, стоящий как чугунный мост. Разумеется это никак не связано с "поощрением" докторов производителями и торговцами этими плацебо БАДами
Разумеется это никак не связано с "поощрением" докторов производителями и торговцами этими плацебо БАДами
Это "поощрение" работает, например, в США, где всё сложнее аспирина - по рецепту, и поэтому есть возможность отследить, сколько рецептов на конкретный препарат выписал конкретный врач. Собственно, ваши стереотипы о поощрении врачей идут как раз из продуктов американской культуры - фильмов, книг и т.д.
А в РФ мало того, что даже большую часть рецептурки прекрасно продают без рецепта, так ещё и врачи (по крайней мере в госке) обязаны МНН в рецепте писать. Некоторые нарушают, но им порой больно прилетает. Я вообще официальные рецепты с фамилией врача только в Германии увидел, в российской поликлинике мне всегда давали просто листочек из ноут-блока с названиями, без каких-либо опознавательных знаков. Российские фармпредставители максимум врачу подарят мерча, блокнотики там, ручки, может быть зонтик или авоську. Даже в ресторан сводить, как в американских фильмах - хрен, про что-то более существенное и говорить не приходится. Даже по мозгам ездят неубедительно, понимают, что толку с этого не будет.
Если говорить об арбидоле и ему подобных - выписывать их врачей заставляет самый мерзкий и жадный барыга - российское государство в лице минздрава. Весь этот скам вписан в официальные протоколы и клинические рекомендации минздрава, а конкретно арбидол - ещё и в список ЖВП. Так что вы не ту сторону воюете.
Ответы на комментарии лучше оформлять через цитаты, как я понял на Хабре так принято 😇
А вообще жду когда они реализуют как в телеге чтобы можно было из теста прям отвечать и ссылаться, хотя…
Разумеется это никак не связано с "поощрением" докторов производителями и торговцами этими
плацебоБАДами
Хм, а так интереснее выглядит, но сложнее реализовать
С мобилки это сложно
Если нормальный препарат + плацебо - это ещё полбеды. Хуже, если пропишут что-нибудь, что противопоказано в твоём случае и может навредить. С таким тоже не раз сталкивался, к сожалению.
Раньше, в инструкции к автомобиль писали как регулировать зазор клапанов, сейчас пишут что нельзя пить тормозную жидкость.
Все верно, тупеем мы (человечество) понемногу.
Что бы писать инструкцию - нужно это уметь делать на общедоступном языке, а большинство разработчиков думают только на своём. И естественно, они это могут написать только на своём, а потом аварии, отказы и каждый прав, потому что понял задачу по своему.
И действительно, это относится ко всему, а не только к разработчикам.
Раньше гарантийного обслуживания автомобилей и всяких касок с осагами не было. А сейчас если напишут как что крутить в машине, и потом по этой инструкции кто-то что-то покрутит и при этом двигатель сломается, то засудят производителя за то, что он такую инструкцию написал, а не то, что у некоторых криворуких руки из ж... растут и они точно следовать той самой инструкции не умеют. Вот и не пишут. А то все автогигагнты разорятся на судах с Васей Пупкиным, который оставил лом в двигателе, пока его по инструкции перебирал.
Раньше, в инструкции к автомобиль писали как регулировать зазор клапанов
В "инструкции к автомобиль" под названием service manual и сейчас пишут, как регулировать зазор клапанов (для тех двигателей, на которых нет гидрокомпенсаторов). Просто автомобили стали достаточно качественными, чтобы водителю не приходилось туда лезть и их регулировать. Вот у меня, например, автомобиль прошел больше 600 к, и за это время клапанную крышку не снимали ни разу. Жигули за такой пробег пришлось бы раза 4 как минимум капиталить, если они вообще бы дожили до такого пробега.
сейчас пишут что нельзя пить тормозную жидкость.
И советские "умные люди" от большого, видимо, ума, травились техническими жидкостями только так, особенно в годы сухого закона. А теперь люди отупели настолько, что даже тосол не пьют. Тьфу.
Раньше автомобили покупали любители автомобилей и инструкция была для них. Сейчас автомобили покупают все и инструкция для всех. Зато сейчас эти все умеют читать, а раньше "все" не умели этого.
Раньше автомобили покупали любители автомобилей и инструкция была для них.
Если речь про период времени между Первой мировой и Второй мировой, то ваш тезис более чем спорен - к этому времени автомобили уже уверенно стали утилитарным объектом, покупаемым не как хобби, а как некий бытовой или промышленный прибор, решающий задачи быта или бизнеса. Разумеется, автомобили для любителей автомобилей были и тогда, и сегодня существуют, но традиционно стоят дорого, потому что в отличие от утилитарных решений, ориентированы они на более чем взыскательного покупателя, причем выпускаются обычно небольшими сериями, по которым невозможно "размазать" затраты на разработку и проектирование. Впрочем, к современному Aston Martin пользовательская инструкция содержит довольно мало сведений по обслуживанию и кустарному ремонту.
Сейчас автомобили покупают все и инструкция для всех.
Сейчас стратегия такова: описать основные органы управления и индикации, описать использование ремней безопасности (примерно три четверти всей инструкции), а по любым неясным вопросам предлагать обращаться за разъяснениями к дилеру или иному представителю. Это понятно, почему так. А именно потому, что невозможно в рамках инструкции предусмотреть все возможные, в первую очередь алогичные и противоречащие здравому смыслу сценарии, а значит производитель закрывает возможность эксплуатировать возможное и очень даже вероятное несовершенство инструкции в судебных исках против себя, когда какой-то идиот или хитрец, изображающий из себя идиота, сделал какую-то очевидно противоречащую здравому смыслу вещь, поцстрадал, и теперь, вместо продолжать страдать от собственной глупости или умелой ее имитации, требует тонны денег компенсации за якобы неправильно написанную инструкцию.
Зато сейчас эти все умеют читать, а раньше "все" не умели этого.
Уровень грамотности на заре автомобилизации уже был довольно высок, как мне кажется. Хотя, наверное, сегодня он еще немного выше.
Я размышлял на тему идеальной документации и сделал вывод, что это - фрактал. Если мы ставим задачу написать такую документацию, что её поймет человек любого уровня компетенций, то задача становится невыполнимой в конечное время.
Представьте себе, если бы на каждое руководство было приложение, как пользоваться терминалом и описание всех задействованых команд, каждого ключа.
А если человек не знаком с клавиатурой? Что ж, описываем и принцип ввода текста.
И так далее... Всегда найдется, что ещё стоит уточнить, если вдруг читатель это не знает.
Поэтому золотое правило написания руководства - определить, под кого его пишем. И определить минимальный уровень компетенций, требуемый для чтения и понимания.
Я помню старые книги толстые про Word и Excel. Половина, утрируя - про то, как включить компьютер и запустить нужную программу. И была такая же толстая сразу про весь пакет Office, включая Powerpoint и Access. И там уже только по делу.
Соглашусь, как вариант, моё решение этого — из комментария: https://habr.com/ru/articles/951794/comments/#comment_28903164
Вау! Спасибочки, у остальных такая не понятная подача. С первого раза все понял!
Вот если бы был какой-нибудь способ читая текст в интернете, выделить непонятное слово и узнать что оно означает. Жалко что нет такого способа в интернете.
А может быть, Не Разработчик, этот туториал просто не для тебя?
Боюсь даже если найдется ссылка на википедию, а не на аналогичный туториал или вообще на репозиторий проекта, то там понятных слов будет столько же.
Ну вот как-то и работает самообучение, да. Спускаешься по цепочке непонятных слов пока не будет первое понятное, и через него возвращаешься обратно с новыми знаниями. И так пока все не станет ясно.
Это не только для айти справедливо, все самообучение так работает.
А не самообучение такое же, только статьи из википедии читает человек, и ему можно задать вопрос.
Я понял идею статьи как "человек ищет возможность сделать Очень Простую Задачу при помощи Snarfus". Да, он мог бы обучиться всем этим словам пройдя онлайн-курсы или упорно погрызя википедию и разного рода туториалы и вводные статьи. Но он не хочет. Он не хочет знать все эти непонятные слова, у него другие интересы, ему просто надо выполнить Очень Простую Задачу, настроить под нее Snarfus и больше в обозримом будущем этих слов не слышать. И это нормально.
А мораль статьи - разработчик создавая туториал должен задумываться в том числе о таких читателях. Поэтому если между пунктами 3 и 4 есть совершенно очевидная для любого разумного человека операция снарфожения, он все равно должен упомянуть о ней, а еще лучше прямо записать ее отдельным пунктом.
разработчик создавая туториал должен задумываться в том числе о таких читателях
Разработчик должен ровно ничего и ровно никому. Туториалы для людей которые вот буквально только что начали тоже существуют, но они обычно в формате учебников всяких, потому что если объяснять каждый термин в пошаговом туториале то туториал будет нечитаем ни как пошаговый, ни как учебник для новичка. Если надо понимать все слова, изучай вопрос, если надо настроить и забыть, делай что написано и не выделывайся что тебе не разжовывают. Туториалы для роботов называются установочные скрипты, может надо такой поискать вместо того чтобы на разрабов давить.
не выделывайся что тебе не разжовывают.
Я и не вижу там выделывания (могу ошибаться, конечно). Автор не просит чтоб ему разъяснили что это за Компания и разжевали каждое непонятное слово, да и про гугл он знает. Он просто пытается выполнить шаги как написано и за семь часов дошел только до третьего. И причины могут быть самыми разными - то ли он гуглил "как выполнить команду в терминале? Как вставить перевод строки на середине команды?", то ли "что вместо surpriz!.file в ometer2.7? GewGawGamma error: тройная силуфимация required for Тпрунь".
С современным словоблудием очень часто вместо спуска до понимания, попадаешь в рекурсию.
Мать собирает сына в поход. В рюкзак кладёт носки, пирожки, гвозди.
Сын спрашивает - зачем?
- Ну ноги промочишь, сразу сухие носки оденешь. Проголодаешься, пирожки покушаешь.
- А гвозди?
- Ну вот же! Положила!
Нашёл следующие краткие сведения:
«СЕПУЛЬКИ — важный элемент цивилизации ардритов (см.) с планеты Энтеропия (см.). См. СЕПУЛЬКАРИИ».
Я последовал этому совету и прочёл:
«СЕПУЛЬКАРИИ — устройства для сепуления (см.)».
Я поискал «Сепуление»; там значилось:
«СЕПУЛЕНИЕ — занятие ардритов (см.) с планеты Энтеропия (см.). См. СЕПУЛЬКИ».
Проблема в том, что гуглить "клин-клонк" бесполезно, ты попадешь на форум, где тебе на таком же языке объяснят, что для клин-клонка нужен настроенный грамелион, а как его настроить уже совсем другая история - это кроличья нора из жаргонизмов
Я опознаю в этом попытку сделать ssh сертификат для работы с git.
Для неразработчиков процесс действительно так себе.
я как-то выполнил эту операцию пошагово, вообще не зная о существовании ssh и о том, что с его помощью можно как-то логиниться на git.
Просто выполнил шаг за шагом иструкцию
Все так, тем не менее она примерно так и выглядит, довольно недружелюбно, хотя может решаться одной формой.
Я тоже пробовал выполнить, но оказалось, что если концы строк обозначены символами ODA,ONET, то интерпретатор выдаёт ошибку "перегрузка эмоционального контура: разрешение не получено", и нужно установить утилиту конверсии в формат ODA,DADA, которая отсутствует в моем репозитории...
Ну наконец-то кто-то написал внятное руководство по Snarfus. Раньше приходилось делать лабудабуда, а теперь наконец-то смогу подключится и радоваться жизни. /s
I don't speak Russian and didn't understand a word in the tutorial. Tutorial is a total shit, author is a bad person. Tutorials should only use words I personally understand.
Hello! Actually, this article is a translation from an English tutorial. So you can read the original version here: https://anniemueller.com/posts/how-i-a-non-developer-read-the-tutorial-you-a-developer-wrote-for-me-a-beginner
Mgimo finished?
Ask!
Обычный международный английский, которым написано пол-Интернета.
И, кстати, если вы будете писать на каком-то другом английском, то просто кратно сократите себе число читателей, вот и всё. (Хотя пара артиклей бы не помешала).
А в какое место вы тут хотите пихать пару артиклей? Тут как раз с ними все ок, один даже лишний.
Почему первый раз “tutorial” написано с определённым артиклем, а второй — нет? Или вы как раз этот считаете лишним?
Я бы убрал “a” перед “total”. Мне встречалось сочетание a total shit <something> (a total shit show, a total shit card), подозреваю, что и автору тоже. Так там “shit” это прилагательное. Может, конечно, автор имел в виду, так сказать, «судачки порционные», в смысле, «г…а кусок», в неформальной речи неисчисляемые существительные вполне используются с неопределённым артиклем, но конкретно это существительное в таком смысле не видел ни разу (видел don't give a shit, take a shit).
Mgimo finished him.
"КГ/АМ" детектед)
Отличная статья. Интересует кто автор КДПВ? И что на ней изображено?
Это плюмбус из «Рика и Морти»
Без скриншотов - не считается. Низачот!
Ну наконец-то кто-то внятно объяснил как это делается))
Спасибо за перевод. Только не понятно, о чем был и зачем (самое главное) написан оригинал.
Так то да, но нет. Прям как инструкция для местной CRM автомастерской, где механики смотрят наряды и выставляют часы работ.
Наверное все-же разработчики пишут такие инструкции для разработчиков... и нечего неразработчикам жаловаться. А для неразработчиков бывают толстые талмуды документации (впрочем их освоение зачастую еще сложнее)
я решил перклеить pintafore с помощью quagmire вместо hoobastank
Ну и правильно. В первой итерации, для работоспособности hoobastank понадобится the reason. А при сиквелизации придется следовать паттерну same direction 😄
С общедоступными нейросетками жаловаться на туториал, когда нейросетка может буквально объяснить любой термин и смысл написанного построив любые желаемые и понятные пользователю аналогии?
нейронка спокойно может ошибиться и перепутать информацию при объяснении каких-то тонкостей работы того или иного механизма
нейронка спокойно может ошибиться и перепутать информацию при объяснении каких-то тонкостей работы того или иного механизма
@moonveil, а ещё бывают галлюцинации
Впрочем, это и есть ошибки…
В итоге вместо одной проблемы (как настроить Snarfus) ты получаешь две: как настроить Snarfus и как отличить правдивый ответ нейросети от ее фантазий. Не уверен, что это упрощение
До боли жиза, ссобенно семь часов и 193 запроса в поисковиках. Причем вы еще легко отделались, обычно на четвертом шаге выясняется, что туториал написан для другой версии Snarfus, а в твоей все пути к файлам другие и команда ajkl;gawgor;iqeg давно deprecated
Автор, спасибо! Смогла настроить мозг на нужную частоту дрожания воздуха вокруг себя этим туториалом.
Привет, так этож не проблема а реальность!
Вокруг каждой предметной области формируется своя среда, свой язык.
Да, формально этот язык все еще считается "русским", но по факту это отдельный язык построенный на базе оригинала. (Как DSL построенный на базе ООП 😁)
Так что тут всё как при изучении любого другого непонятного языка, пока не прояснишь каждое непонятное слово и\или связку слов - будет непонятно.
Если учить математику или шахматы по книге написанной математиком или шахматистом тоже будет примерно так же, я читал 😁. (И так в любой теме которая формирует вокруг себя свой язык)
Потому для понимания важен не только текст, а привязка написанного к реальности, и желательно к реальности читателя.
Оно должно быть скриптом. Автоматизирование тпруней первый шаг к стабильным шкреллионам
А, так вот кто разработал эту игру https://store.steampowered.com/app/727640/SHP__ShP/
А до какой степени автор хочет разжёвывания гайдов?
Допускаем ли мы, что обратившийся к гайду человек умеет читать, или пользоваться таким инструментом как "письменность" мы тоже должны научить?
Вообще не поддерживаю придирку к тому, что в гайдах пользуются неизвестными читателю инструментами. Это не проблема гайда, это проблема читателя - пусть сначала прочитает гайды по тем инструментам.
И ещё прибегу к аналогии.
Если в медицинской литературе я не пониамю фразу "что при ангионевротическом отёке необходимо ввести эпинефрин в vastus lateralis", а "кристаллоиды надо ввести в режиме болюсной инфузии", то это же мои проблемы, а не медицинской литературы? Мне же надо сначала каждый из этих терминов отдельно изучить, и потом браться за инструкцию?
Почему в айти тогда действуют другие правила?
Если в медицинской литературе я не пониамю фразу "что при ангионевротическом отёке необходимо ввести эпинефрин в vastus lateralis", а "кристаллоиды надо ввести в режиме болюсной инфузии", то это же мои проблемы, а не медицинской литературы? Мне же надо сначала каждый из этих терминов отдельно изучить, и потом браться за инструкцию?Почему в айти тогда действуют другие правила?
Это вот хороший пример нонконформистской профессиональной культуры. Сверхгибкий и высокооплачиваемый рынок взращивает людей, привыкших к личному комфорту, у айтишников это максима. Я не считаю это чем-то плохим, но сравнивая со своей профессиональной средой, вижу, что у них вообще все по-другому (ну а таких как я они считают прогнувшимся под систему конформным червем, который на работу к 9-ти ездиет, ну штош).
Я мысль у Luke Smith (канал на YT) такую подчерпнул: чем доступнее становится ПО, не тем меньше становится запросов от "заблудившихся" пользователей, а тем далее падает уровень привлеченных пользователей, в итоге условных "дураков"-юзверей стало больше.
То есть как бы и хочется упростить жизнь, но потом все равно придется сражаться с ламерами, которым всё разжуй. И может быть выход тогда только в принудительной монетизации поддержки?
От себя же, прочувствовав боль из статьи за длинным опытом, пытаюсь именно так и писать тексты, чтобы не только показывать шаги, но и объяснять для чего каждый нужен. Какое это иначе обучение? ...хотя припоминаю, оставались такие, которым влом/слишком длинно/"ничего не понял"/"у меня картинки не совпадают" при наличии четких оговорок, куда идем и где что искать.
А до какой степени автор хочет разжёвывания гайдов?
@plFlok, пишу инструкции, и тоже задавался этим вопросом. Мне кажется хорошим тоном будет указывать (или ссылаться) на минимально необходимый багаж знаний для применения гайда, или что-то в этом роде. Типа параметров: Вы должны знать: Русский язык; Пользоваться ПК (определить на сколько) и т д.
Запарно, да, соглашусь, но всё же это поможет экономить время «А точно ли мне стоит это делать? или лучше делегировать обратившись к профессионалам»
И тут пришёл g-переводчик и всё испортил: он знает тпрунь! ЗНАЕТ! ТПРУНЬ!
https://translate.google.com/?sl=ru&tl=en&text=тпрунь!&op=translate
Наконец-то внятное руководство по Snarfus, а то я все по старинке через hoobastank перклеивал, а оно оказывается вон как надо, через задний стагнатор. Пойду пробовать
Зачем неразработчику читать статью разработчика на специальную тему? Совершенно аналогичное ощущение возникает у любого неспециалиста при чтении неадаптированной статьи/монографии на любую тему - куча каких-то непонятных слов, обозначений, аббревиатур...
Отличный материал, возьму на заметку
Кстати, если серьезно, у нас в компании (даже по всей корпорации) был такой перк под названием key user. Перк, потому что это не название должности и даже не часть должностной инструкции. Плюшками был инсайд в грядущие изменения, возможность выносить мозг программистам своими идеями по оптимизации бизнес процесса при помощи плагина или кастомной транзакции в SAP, ну и определенная доля респекта среди работяг, которые тоже используют MESы и WMSы на регулярной основе и начальства. Короче этакий эникейщик внутри отдела. Собственно, этому эникейщику и предстояло писать (или переводить с айтишного языка на русский и английский) всевозможные мануалы и обучать "простых смертных" как пользоваться системой правильно и объяснять почему именно так, а не эдак. Ну и это кстати работало, если key user хороший и знает как и почему крутятся шестерёнки
Да ладно, все сюжеты фантастических фильмов построены на подобных диалогах :)
Очень полезная инструкция. Но я бы хотел видео-версию на ютубе, часа на полтора! С рекламой и нативными интеграциями
Я придумал нынче лайфхак. Когда разбираюсь в новой документации ресурса и присоединяюсь к чату людей которые пользуются этим ресурсом я пишу что не понял как сделать что-то и прикрепляю ссылку на документацию. Тогда им приходится говорить как они это делают, и указывать на возможные ошибки вместо отправки ссылки на документацию
Как я, не разработчик, читаю туториал, который ты, разработчик, написал для меня