Update documentation

use string.Template style replacement markers in existing examples
and add declarative configuration description and example.