[nooyurrsdey]

prism.js the code syntax highlighter is notoriously bad at this.

At first I felt bad for being confused by something so simple. But all their code examples for highlighting refer to their own code and you're right, at the exact moment you're trying to absorb new information it is infuriating to deal with the "meta" examples.

I don't use them out of that alone.

[slhck]

This is my main issue with Rspec documentation.

[pizzapill]

RSpec has none of that, a typical example from the first page of their documentation:

  RSpec.describe Widget do
    example do
      expect(described_class).to equal(Widget)
    end
  end

Pretty non-meta.