Про прописанное ТЗ и инструкции
Сейчас прохожу интенсив по 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» при создании блокнота Проблема: Не было прав на создание файлов в системной папке
Решение: Перешла в свою домашнюю папку, где есть права на запись.
Иными словами - я рада, что хотя бы не было написано, как в кулинарных рецептах, сколько времени это должно занимать у нормальных пользователей, иначе я бы сильно расстроилась))
Вот и думаю - дело только во мне, или я просто не ЦА, или о таких нюансах всё-таки стоит писать, если ваша задача донести информацию до джуна? Или это тоже своего рода естественный отбор?