Open main menu

Changes

Created page with "Charles Fishman wrote a terrific article ''[https://www.fastcompany.com/28121/they-write-right-stuff They write the right stuff.]'' <ref>Fishman, C. (2017, September 8). ''The..."
Charles Fishman wrote a terrific article ''[https://www.fastcompany.com/28121/they-write-right-stuff They write the right stuff.]'' <ref>Fishman, C. (2017, September 8). ''They write the right stuff''. Fast Company. <nowiki>https://www.fastcompany.com/28121/they-write-right-stuff</nowiki></ref> for Fast Company magazine in 1996 about the "on-board shuttle group" that works at the Johnson Space Center in Houston, TX producing some of the most sophisticated and error-free software in the world.

We'll try to focus on some best practices and quality metrics - especially as it relates to MediaWiki.

<br />

== Cliff notes for process at WMF ==

* [[mediawikiwiki:Development_guidelines|Development_guidelines]] provides the big picture of policies (MUST) and guidelines (SHOULD).
* [[mediawikiwiki:Manual:Coding_conventions/PHP|Manual:Coding_conventions/PHP]] covers aspects of how PHP for MediaWiki is coded.
* [[mediawikiwiki:Code_Stewardship|Code Stewardship]] is a model adopted in 2018 by WMF as a layer on top of [[mediawikiwiki:Developers/Maintainers|Developers/Maintainers]]
* [[mediawikiwiki:Manual:Mwdocgen.php|Manual:Mwdocgen.php]] generates the Doxygen output, but the [[mediawikiwiki:Manual:Coding_conventions/PHP#Comments_and_documentation|Manual:Coding_conventions/PHP#Comments_and_documentation]] doesn't mention anything about comments for [[static analysis]]
* '''[[phab:T240307|Hook container with strong types and DI]]''' (solved) is part of a series of architecture shifts, and is an example of diving into the details of the codebase.
* [[mediawikiwiki:API:Client_code/Gold_standard|API:Client_code/Gold_standard]] is somewhat interesting - a series of metrics and principles applied to the API Clients listed at [[mediawikiwiki:API:Client_code|API:Client_code]]

== Code Health - project ==
MediaWiki [[mediawikiwiki:Code_Health|Code_Health]]

[[mediawikiwiki:Code_Health_Group|Code Health Group]] - paused, planned to restart in 2024

[[mediawikiwiki:Code_Health_Group/Quality_Big_Picture|Code_Health_Group/Quality_Big_Picture]]

[[phab:project/view/3621/|Workboard in Phabricator]]
<br />