extended documentation for scalar example

Extended documentation of the scalar example.
you might want to move this block into the one below for the `ScalarSweeper` class