Делать самодокументируемые расчеты в форме ноутбуков - это очень легко и полезно даже самому автору. Однажды мне пришлось долго разбираться с 20-ю файлами кода автопилота. Вместо документации у меня были скудные комментарии в коде и ссылка на внутреннюю вики за VPN, которого у меня не было. Автор еще работал в команде, но уже и сам забыл причины выбора одного из устаревших алгоритмов.
В итоге алгоритм автопилота я разобрал и улучшил за три недели, но без ноутбуков это привело к чрезмерной растрате времени.
Почему бы всем и всегда не писать вменяемые заметки, формулы, картинки и не размещать фрагменты документации рядом как ДО так и после секции с кодом? В инженерных задачах это должна быть одна из best-practice.
Кстати, ноутбуки в Engee на мой взгляд круче, чем в Google Colab.