Page MenuHomePhabricator

NormalizedException not shown on doc.wikimedia.org
Closed, ResolvedPublic

Description

NormalizedException doesn't show up at https://doc.wikimedia.org/ in the "boxes" section. The documentation exists and is listed on the index page, but not on the main page. Is that manually maintained? Are there extra criteria for what does or doesn't get shown there? It took me a while to figure out that it isn't just a case of documentation generation being broken...

Event Timeline

Tgr renamed this task from NormalizedException has no auto-generated documentation to NormalizedException not shown on doc.wikimedia.org.Jan 22 2023, 9:59 PM

Thanks!

Plenty of things seem to be missing from there. Is it expected to be in sync with e.g. https://www.mediawiki.org/wiki/Category:PHP_libraries or does it express some kind of judgement about importance?

Also, is there some tooling or is the config file maintained by hand?

The opensource.yaml file is manually edited and there is no tooling to ease additions to it. We do not have any editorial guideline as to which projects can be added there, anything can be added :-]

Change 965840 had a related patch set uploaded (by Gergő Tisza; author: Gergő Tisza):

[integration/docroot@master] Add more libraries

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

Change 965840 merged by jenkins-bot:

[integration/docroot@master] Add more libraries

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

Mentioned in SAL (#wikimedia-operations) [2023-11-13T08:34:22Z] <hashar@deploy2002> Started deploy [integration/docroot@bc8aaba]: Add more libraries to doc.wikimedia.org homepage - T327604

Mentioned in SAL (#wikimedia-operations) [2023-11-13T08:34:29Z] <hashar@deploy2002> Finished deploy [integration/docroot@bc8aaba]: Add more libraries to doc.wikimedia.org homepage - T327604 (duration: 00m 06s)

Tgr claimed this task.