User:APaskulin (WMF)/Sandbox/Development guidelines

The MediaWiki software is developed collaboratively by people from all around the world. To help facilitate this process, standards of desirable practices have been established.

Policies

Development policies describe what developers must do. There can be no deviations from policies.

Support policy for PHP

Criteria and process for PHP version support in MediaWiki core and components

Gerrit privilege policy

Code review rights and responsibilities for MediaWiki core and components

Stable interface policy

Annotation conventions and deprecation process for stable interfaces in MediaWiki

MediaWiki database policy

Policy for MediaWiki database queries and database schema changes

Architecture principles

Development principles and practices for Wikimedia engineering projects

Services policy

Principles for developing and deploying a Wikimedia service

Guidelines

Unlike policies that describe what developers must do, development guidelines describe what developers generally should do. Minor deviations from guidelines, like coding conventions, can often be allowed based on individual circumstances. Whether there is good reason for a given deviation that is worth the downsides of conformity to the established norms is a matter for judgment of developers and their code reviewers.

Security and performance

• Security for developers
• Security checklist for developers
• Backend performance guidelines

Code commits

• Commit message guidelines
• Pre-commit checklist

Design and documentation

• Localisation
• Accessibility guide for developers
• Design style guide
• Documentation/Style guide
• Inclusive language

Coding conventions

• PHP
• PHPUnit
• JavaScript
• CSS
• Selenium
• Python
• Ruby
• Java
• SVG
• Vue
• Database schemas

APIs

• Standards for API client libraries

Drafts

• Code documentation
• Best practices for extensions