programming_presentation/presentation-notebooks.adoc

29 lines
753 B
Plaintext

== Working with notebooks
=== !
Notebooks are a powerful tool for scientific programming
* Lets you keep a detailed record of your work
* Everything is in one place
* Allows interactive code and data exploration
* Easy to share
=== how to work with notebooks?
[%step]
* **Plot everything**
* Write detailed explanations of what you do, and why
** Unless you have a very specific kind of reader, explain also "well known" methods
** Btw, learn Markdown
* Keep your notebooks reasonably short
* Create different notebooks for different aims
* Refactoring usually means taking the code and putting it auxiliary files
//---------------------------------------------------------
=== Guided example: Machine learning workflow
image::xl23h24nc.jpg[]