As part of my Clinic Duty rotation, I add a project tag and move this task to "To Estimate" because the task is clear enough to be sized and valuable in our current hypothesis.

Notes for estimation:

• T427356 (externalDocs support) is now complete, so that item is unblocked
• Remaining unblocked work: add termsOfService, contact.name, and contact.url in ModuleSpecHandler.php, and remove unused components
• The unused components removal requires an audit: the generated document defines ~16 components (parameter type schemas + generic error response) but most are likely never referenced via $ref — the fix involves either removing them from generation or switching to $ref references, a decision that may affect how external tools consume the OAD
• version semver field is still blocked on T427359 and should be excluded from the estimate
• Changes are concentrated in a single file (ModuleSpecHandler.php), no logic changes — low risk

FYI, these are the components where there is an oas3-unused-component warning. Each of these components currently also triggers a wikimedia-schema-example-recommended warning, which will disappear too when we make this fix!

components.schemas.boolean-param
components.schemas.enum-param
components.schemas.integer-param
components.schemas.float-param
components.schemas.double-param
components.schemas.password-param
components.schemas.string-param
components.schemas.timestamp-param
components.schemas.upload-param
components.schemas.expiry-param
components.schemas.namespace-param
components.schemas.title-param
components.schemas.user-param
components.schemas.array-param

Change #1308640 had a related patch set uploaded (by Milazg; author: Milazg):

[mediawiki/core@master] Rest: Fix top-level issues in the MediaWiki REST API OAD

https://gerrit.wikimedia.org/r/1308640