programming_presentation/presentation-notebooks.adoc

!

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?

• 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