Jeff King [off-list ref] writes:
I think it is OK as-is, but it might be easier to follow visually with
text like:
Here's a sample patch that we'll use below.
-----
$ cat the-patch, etc
-----
We can apply it with `git am`, which will create a new commit:
-----
$ git am ...etc...
-----
Especially in the HTML version, which puts the code blocks into a box
with a different backgrounds, that makes it easy to visually jump to
each box without having to carefully read the contents.
I agree that presentation-wise the above style is much nicer to
follow.