HSEARCH-1363 Formatting and style improvements in the documentation

Some of these whitespace changes are essential to render product documentation without awkward line breaks.

Some other changes are applied just to have a consistent spacing in the whole example.

Some more very minor improvements included as well.