https://gerrit.wikimedia.org/r/#/c/190116/ didn't really make @example work.
It fulfilled jsduck's requirement of having an eg-iframe.html file, but the examples don't yet work.
https://doc.wikimedia.org/oojs-ui/master/#!/api/OO.ui.ButtonInputWidget
ReferenceError: OO is not defined
Location: https://doc.wikimedia.org/oojs-ui/master/ 404 (Not Found) https://doc.wikimedia.org/oojs-ui/lib/oojs.jquery.js 404 (Not Found) https://doc.wikimedia.org/oojs-ui/dist/oojs-ui.js 404 (Not Found) https://doc.wikimedia.org/oojs-ui/dist/oojs-ui-apex.js 404 (Not Found) https://doc.wikimedia.org/oojs-ui/dist/oojs-ui-apex.css
It's stabbing in the dark by loading things from a parent directory that it thinks is the oojs-ui git root, but is actually an unrelated directory holding different versions of oojs-ui documentation. The docs/ published from Jenkins needs to be self-contained.