Что делать, когда официальная документация ужасна

Плохая документация — одна из самых универсальных проблем в обучении. Вы идёте к официальному источнику за ясностью и находите жаргон, пропущенные шаги и примеры, которые предполагают, что вы уже знаете то, что пытаетесь выучить. Это не ваша вина. Большая часть мировой документации написана экспертами, которые забыли, каково это — не знать. Они пропускают шаги, которые кажутся им очевидными, но для вас невидимы.

Когда официальные доки подводят, ищите шире. Ищите обучающие статьи в блогах, видеоразборы от людей, которые недавно это освоили. Смотрите реальные примеры и открытый исходный код. Задавайте конкретные вопросы на форумах — не «как работает X», а «я попробовал Y и получил Z, чего мне не хватает». Одни из лучших учебных материалов написаны разочарованными новичками, потому что они помнили именно те шаги, которые официальная документация забыла включить.