Add synopsis with simple example
edits
changelog
Merge branch 'pr/981' into devel

Fixes #981