2021-12-20 Feedback по jupyter-ноутбукам

Просмотрел несколько видеопрезентаций по юпитер-ноутбукам.

• Часто встречается паттерн «свалка кода сбоку» в рядом лежащих питон-файлах, в ноутбуке только интерфейс к какому-нибудь простому интерфейсу. Это конечно, не то, что хотелось бы.
  • Почему это плохо?
  • Такой ноутбук «не работает» как передача знаний, он бесполезен, он не лучше, чем кусок кода, ибо все равно
    • разбирающемуся придется реинженирить код, его функциональные связи, что там и что означает…
    • такой ноутбук не «расшарить» в colab.research.google.com или cocalc.com (там всегда плохо на тему шаринга рядом лежащих файлов).
    • он не работает как презентация-пояснение-живой плейграунд («а что если тут поменять XXX»?).
• Посмотрите реально примеры и разбор из Blog:Advanced Algorithms/2021-12-01 Как делать лучше jupyter по статьям
  • Последовательно вводите понятия, каждая питон функция в отдельной ячейке, в ячейке перед ней — описание, в ячейке после нее — примеры вызова с характерными данными.
  • Не бойтесь, если будет длинно — никогда не жалейте места для лишних слайдов или ячеек в ноутбуках — в зависимости от аудитории, слайды-ячейки можно пропустить, зато гарантирует, что хоть кто-то разберется в теме (включая вас, такой рефакторинг для научного ресерча — самый эффективный способ найти проблему).
• Вот пример неплохого доклада → https://youtu.be/XeZTpQWTDUU (ноутбук)
• По срокам — я выторговал в деканате до 25го, но лучше не задерживать до последнего момента.

StasFomin 13:56, 20 декабря 2021 (UTC)

[ Хронологический вид ]Комментарии

(нет элементов)

Войдите, чтобы комментировать.

— Стас Фомин • 13:56, 20 декабря 2021 • нет комментариев