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