Improved handling of expected vs actual outputs of a command in Interactive Mode

[rgardler-msft]

Currently, in interactive mode, the user is presented with the content ahead of the next command block, it then pauses, waiting for the user to execute the command. Once executed it moves directly to the next command block.

This means that the following undesirable effects are present:

• The user is not shown, in advance, what the command is expected to do
• The actual output of the command is never shown to the user
• Any descriptive text between the executable code block and the results is never displayed

This behaviour can be observed in the docs/README.md file.

Proposed Solution

1. Display all content up to and including the results block if one exists, or the next heading if no results block exists
2. Display the output in the output section and ask the user to interact to advance (spacebar, e or right arrow)