extended documentation for scalar example

Extended documentation of the scalar example.
either two stars or make it a one-line comment with `//!` (exclamation mark for Doxygen)