docs: update examples

[romanc]

Description

This PR updates the NDSL examples. It's an old PR from Chris that I've resurrected. Merging around Halloween seems fitting. Fixes a bunch of typos, markdown syntax and clarifies some of the examples in text.

How has this been tested?

Self review of code/notebook

Checklist

• My code follows the style guidelines of this project
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas: N/A
• I have made corresponding changes to the documentation (e.g. add new modules to docs/docstrings/)
• My changes generate no new warnings: N/A
• Any dependent changes have been merged and published in downstream modules: N/A
• New check tests, if applicable, are included: N/A

[FlorianDeconinck]

Thank you 👻 !