Use includes for embedding code snippets

This commit ensures that code snippets displayed in the guide always
stay in sync with the actual application code by including their content
in the guide through `include::` directives.

This also improves the structure and content of the guide in various
places.