# Format of notebooks#

There are no rigid guidelines on how notebooks should be crafted but it is important to outline a philosphy to try to follow as much as possible in orde to create coherent content.

Design guidelines

Use well established and stable libraries in scientific python3 ecosystem;

**numpy, scipy, pandas, ipywdigets, matplotlib, seaborn, plotly and pyviz.**

Avoid rapidly evolving specialized packages.

Build the interactive content from scratch using basic building blokcs of numpy, scipy and matplotlib.

All the code should be self-contained and sotred inside jupyter notebook.

Document all functions and use PEP8.

Keep background material to the minimum.

Have well documented functions.

Main sections of the notebook

Objectives: List what are the objective of the notebook. What concepts will students learn.

Background: have a succinct summary of prerequisite theory with links to wikipedia or other preferably free resource.

Code: Have a set of clean well documented python functions relying on numpy, scipy and matplotlib as much as possible. Do not write excessive comments.

Applications: Show how to use the code with explanations and examples

Exercises and Problems: Provide a few exercises with solutions and Problems