Rewrites example and text to avoid repetition
Rewrites example and text to avoid repetition

This fixes #2237, but also refers to #1924. It's always better to have
two valid examples, than to have a single one.

Another alternative is, of course, to eliminate indexing of one of
them, but this is probably better.

stmuk/doc,perl6/doc,dmaestro/doc,tbrowder/doc,perl6/doc,perl6/doc,stmuk/doc,jonathanstowe/doc,perl6/doc,stmuk/doc,dmaestro/doc,jonathanstowe/doc,dmaestro/doc,perl6/doc,MasterDuke17/doc,MasterDuke17/doc,jonathanstowe/doc,tbrowder/doc,jonathanstowe/doc,MasterDuke17/doc,dmaestro/doc,stmuk/doc,dmaestro/doc,stmuk/doc,tbrowder/doc,tbrowder/doc,MasterDuke17/doc,jonathanstowe/doc