Просмотр исходного текста страницы Blog:Advanced Algorithms/2021-12-20 Feedback по jupyter-ноутбукам

Просмотрел несколько видеопрезентаций по юпитер-ноутбукам.
* Часто встречается паттерн «свалка кода сбоку» в рядом лежащих питон-файлах, в ноутбуке только интерфейс к какому-нибудь простому интерфейсу. Это конечно, не то, что хотелось бы.
** Почему это плохо?
** Такой ноутбук «не работает» как передача знаний, он бесполезен, он не лучше, чем кусок кода, ибо все равно
*** разбирающемуся придется реинженирить код, его функциональные связи, что там и что означает…
*** такой ноутбук не «расшарить» в colab.research.google.com или cocalc.com (там всегда плохо на тему шаринга рядом лежащих файлов).
*** он не работает как презентация-пояснение-живой плейграунд («а что если тут поменять XXX»?).
* Посмотрите реально примеры и разбор из [[../2021-12-01 Как делать лучше jupyter по статьям]]
** Последовательно вводите понятия, каждая питон функция в отдельной ячейке, в ячейке перед ней — описание, в ячейке после нее — примеры вызова с характерными данными.
** Не бойтесь, если будет длинно — никогда не жалейте места для лишних слайдов или ячеек в ноутбуках — в зависимости от аудитории, слайды-ячейки можно пропустить, зато гарантирует, что хоть кто-то разберется в теме (включая вас, такой рефакторинг для научного ресерча — самый эффективный способ найти проблему).
* Вот пример неплохого доклада → https://youtu.be/XeZTpQWTDUU ([https://discopal-lab.0x1.tv/share/public_paths/c014c2eda4407e98e4b9dc3d193ff30b502acb89 ноутбук])
* По срокам — я выторговал в деканате до 25го, но лучше не задерживать до последнего момента.
[[Участник:StasFomin|StasFomin]] 13:56, 20 декабря 2021 (UTC)
{{wl-publish: 2021-12-20 13:56:30 +0000 | StasFomin }}