Our eslint rules warn against usage of ~'
The tilda seems to be permitted by https://jsdoc.app/about-namepaths and the ' character helps us work around "." being misinterpreted as referring to a namespace.
This is used mostly to document hooks:
https://doc.wikimedia.org/mediawiki-core/master/js/Hooks.html
When changing from
* @event ~'wikipage.categories' * @memberof Hooks
to
* @event ~wikipage.categories * @memberof Hooks
the hook documentation disappears from the hooks page
We should our explore our options here
- Disable the lint rule
- Adapt jsdoc theme so that we can remove the quotes
- Document without the "." and correct this in the theme.
* @event ~wikipage_categories * @memberof Hooks
- Other?