Про прописанное ТЗ и инструкции

Сейчас прохожу интенсив по ML от одной онлайн-школы.

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

Так вот, просто хочу чуток пожаловаться.

Как пишут в ведении инструкцию по установке Jupyter Lab:

"- открываем командную строку

Windows: нажмите Win + R, введите cmd, нажмите Enter;

macOS: откройте приложение Terminal через Spotlight (Cmd + Пробел → введите «Terminal»).

- пишем pip install jupyter lab

- далее, чтобы открыть ноутбук, вам нужно будет зайти в командную строку из папки, где вы будете работать (или же написать в командной строке, например, для Windows: cd 'C:\Users\ваш_путь_до_папки'

- из папки (или после выполнения команды выше) написать: jupyter lab

- вкладочка с ноутбуком должна автоматически появиться в браузере

- если этого не происходит, можно открыть ее, вставив в адресную строку браузера одну из следующих строк..."

И как в итоге выходит у меня:

1. 🚀 Запуск и первые ошибки Проблема: При попытке установить Jupyter Lab командная строка писала, что Python не установлен или команда не найдена.

Решение: Поняла, что нужно использовать команду python -m pip вместо просто pip.

2. ❌ Ошибка в командной строке «Синтаксическая ошибка в имени файла» Проблема: Переход в папку не работал из-за неправильных кавычек.

Решение: В Windows нужно использовать двойные кавычки " " или не использовать кавычки вообще.

3. ⚠️ Установка сорвалась из-за слишком длинного пути (Ошибка OSError) Проблема: Jupyter не мог установиться из-за ограничения на длину пути в Windows (260 символов).

Решение: Включила поддержку длинных путей через редактор реестра (regedit) и перезагрузила компьютер.

4. ✅ Jupyter наконец запустился, но страница в браузере не открылась Проблема: Командная строка показала ссылку, но браузер не появился автоматически.

Решение: Вручную скопировала ссылку с токеном из командной строки и вставила в браузер.

5. 🚫 Ошибка «Permission denied» при создании блокнота Проблема: Не было прав на создание файлов в системной папке

Решение: Перешла в свою домашнюю папку, где есть права на запись.

Иными словами - я рада, что хотя бы не было написано, как в кулинарных рецептах, сколько времени это должно занимать у нормальных пользователей, иначе я бы сильно расстроилась))

Вот и думаю - дело только во мне, или я просто не ЦА, или о таких нюансах всё-таки стоит писать, если ваша задача донести информацию до джуна? Или это тоже своего рода естественный отбор?