Page MenuHomePhabricator

Create documentation about the proper use of the dependency injection infrastructure in MediaWiki
Open, MediumPublic

Description

Such documentation should include:

  • A brief overview of DI principles, with pointers to further reading
  • A what-is-what-and-where of the relevant classes
  • A list of dos and don'ts, and best practices
  • Pointers to example code

Event Timeline

Krinkle added a project: TechCom.
Krinkle added a subscriber: Krinkle.

Re-tagging as TechCom given Architecture is now archived. @daniel Is this something we could formulate as part of a development policy or coding convention?

Krinkle triaged this task as Medium priority.Mar 14 2018, 8:36 PM
Krinkle moved this task from Inbox to Backlog on the TechCom board.

Related: document proper use of dependency injection in MediaWiki libraries (e.g. T221041: Convert Parsoid to dependency injection).

This task has been assigned to the same task owner for more than two years. Resetting task assignee due to inactivity, to decrease task cookie-licking and to get a slightly more realistic overview of plans. Please feel free to assign this task to yourself again if you still realistically work or plan to work on this task - it would be welcome!

For tips how to manage individual work in Phabricator (noisy notifications, lists of task, etc.), see https://phabricator.wikimedia.org/T228575#6237124 for available options.
(For the records, two emails were sent to assignee addresses before resetting assignees. See T228575 for more info and for potential feedback. Thanks!)

Tagging CPT as they are actively working on converting things to use dependency injection and documentation should be part of that work. There is a help page but it is unfinished.