One of the current WMF goals is to [establish a single entry point for key technical documentation](https://www.mediawiki.org/wiki/Developer_Advocacy/Developer_Portal).
The site [doc.wikimedia.org](https://doc.wikimedia.org) mostly hosts [auto-generated docs thanks to CI](https://www.mediawiki.org/wiki/Continuous_integration/Documentation_generation).
The frontpage of `doc.wikimedia.org` however has seen some custom changes in the last 10 months (see [changelog](https://gerrit.wikimedia.org/r/plugins/gitiles/integration/docroot/+log/master/org/wikimedia/doc/opensource.yaml) of [YAML file](https://gerrit.wikimedia.org/r/plugins/gitiles/integration/docroot/+/master/org/wikimedia/doc/opensource.yaml) defining its content; initiated in 07392c22 by @Krinkle, offering a clean and adaptive layout, sections with boxes (which include programming language information and further links).
To avoid reinventing wheels and https://xkcd.com/927/ , we should explore if doc.wikimedia.org could serve as a base to iterate on.
* Cognitive: Would expanding that page / site try to cover too many use cases (scope becoming too broad) for a reader?
* Social: Shared sense of 'ownership' / gatekeeping / page scope, as 'page maintainers'?
* Technical: Would expanding the page / site be technically possible and feasible? Structure and organization tbd. Vague thoughts (not necessarily good ones):
** Could the top bar be turned into a navigation bar, and have e.g. three such [sub]pages (each based on a YAML file) be linked in that top bar, to create the top level of documentation categorization?
** Could the top bar have a logo (`shared/DocHomePage.php`; `lib/wmui-page.css`)
** Could there be indexing items per programming language, and then (separate step) allow (on-the-fly?) filtering the view per programming language?
** Could an item have more than one `lang` entry?
** Could the CSS for programming languages be adjusted to have each programming language have a specific background color?
** Could there be a search function? (could be overhead)