Jeff King <peff@xxxxxxxx> 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.