Better ApiDoc definitions

[notbakaneko]

Fixing apidocs with wrong auto-generated examples, etc. Moving repetitive definitions to attributes so their values can be set be params instead of repeating the whole thing every time. Using attributes because customizing the parsing for phpdoc blocks is not so great...

• [x] #11499

closes #11427

~~Draft while I get better ideas on handling params~~ going to stop here for this part before the scope creeps forever