DOC: Fix demo notebook generation, and make some adjustments to documentation

Paul McCarthyrequested to merge
doc/demo into main

Merge request reports