While working on T246162 we hit some confusion with the documentation of HTMLForm
There is documentation on mediawiki.org and in the codebase which differs drastically.
Related discussion on https://gerrit.wikimedia.org/r/577340
- It is clear how the mw.org page relates to the docblock code and how the mw.org is updated
- The canonical documentation is up to date and states that it is the canonical source.
- The @todo block regarding section should be removed from the docblock