Fresh docs have arrived! 
Here’s everything we know about writing great notebooks after years of working with nbdev:
The article walks you through the practices we use to leverage the full power of notebooks. Our approach weaves code, tests, and docs into a single interactive context. If you prefer to learn by example, I recommend starting with the annotated example at the end, then branching out to the various principles from there.
We’re always open to improving our workflows and don’t like to be too prescriptive about style. If you have any ideas, please feel free to post them here.