jtyrrell and scholzj recommend we replace <my-topic> type things with topic-name in italics with no brackets so I can copy and paste it and it works. Use italics for the visual, but no brackets since they break things.

"less you have to type the better it is - the less that can go wrong - so instead of <replaceable> have it be a term that works when you copy - italics wihtout brackets gives you a visual and it works right from the copy/paste"