@defuneste I think my issue is they're a compromise that is bad at communicating the two things that are in them, the method (code) and the results (text and graphics):
- if you want to share code with people, notebooks tend to be spaghetti code, with lots of things not clearly put into functions, just duplicated cells with minor variations. Any interesting or significant code should be in a separate file anyhow, so they're hard for others to understand
- if you're presenting results and graphics to people, who normally can't code, they need a separate presentation anyway, you can't share the notebook with them, which they won't know how to run, and a presentation/email is quicker and clearer.
If you want images inline with Python I think the iPython is good, but with all your code in 'normal' python files.
(Oh and the git issues others have mentioned, but that's secondary for me.)