Comments in Extension Examples

I’ve produced an extension (yay) but with the examples, comments don’t appear in either the Documentation or after it’s been pasted over.

Is it just me, or can anyone reproduce this? Should I report it as a bug?


WI 25.10 says:

Note that text in square brackets should be avoided in the documentation, because that’s taken as being comment matter on the extension, and omitted.

You could suggest a different behavior at uservoice though.

Edit: removed stray space

There’s a related request at uservoice already: … esentation


Yeah, this bugged me too when I wrote a couple of extensions. It seems quite arbitrary for them to have done it this way, as well as a bit annoying for extension authors.


Thanks everyone – I’ll throw my vote in at uservoice and hope for the best.