Replace docs/design.txt with a reasonably complete summary of how MW works
Open, LowPublic
Actions

Assigned To

None

Authored By

	• RobLa-WMF
	Sep 2 2015, 11:14 PM

Description

docs/design.txt is old and not very useful, but is probably frequently skimmed by new developers. Let's make it useful.

https://www.mediawiki.org/wiki/Architecture_guidelines is what we should want people to read. That document should be taken with the same level of seriousness that https://www.mediawiki.org/wiki/Security_for_developers gets. Let's actually make a piece of it part of our source tree, and point to https://www.mediawiki.org/wiki/Architecture_guidelines from docs/design.txt

Details

	Subject	Repo	Branch	Lines +/-
	docs: Remove outdated information from globals.txt	mediawiki/core	master	+0 -2

Customize query in gerrit

Related Objects

Mentioned In: T111298: make doc files in git more useful
Mentioned Here: T111298: make doc files in git more useful

Event Timeline

• RobLa-WMF created this task.Sep 2 2015, 11:14 PM

• RobLa-WMF raised the priority of this task from to Needs Triage.

• RobLa-WMF updated the task description. (Show Details)

• RobLa-WMF added projects: Architecture, Documentation.

• RobLa-WMF subscribed.

Restricted Application added a subscriber: Aklapper. · View Herald TranscriptSep 2 2015, 11:14 PM

Krinkle subscribed.Sep 3 2015, 12:05 AM

• Spage mentioned this in T111298: make doc files in git more useful.Sep 3 2015, 1:25 AM

Sounds good.

doxgen turns this into garbled https://doc.wikimedia.org/mediawiki-core/master/php/design_8txt.html , aggh. I created T111298: make doc files in git more useful but it's deliberately not a blocker of this.

• MZMcBride subscribed.Sep 3 2015, 5:44 AM

Just make design.txt a pointer to the wiki page?

• demon updated the task description. (Show Details)Sep 3 2015, 5:48 AM

• demon set Security to None.

Just make design.txt a pointer to the wiki page?

No. We need to make it so that:

People looking for something using code search tools (e.g. grep) to find an important architectural concept (maybe hoping to find something in the comments) actually find this document
At least some of our design is actually documented in the code, and that we're not breathing so much of our own exhaust that we think everything can most comfortably be used on a wiki
The thing we're pointing to is actually worth reading, and doesn't have "draft" on the top of it after ... how many years?
Changes to the core document are treated seriously in code review, and use our code development process for its development

Glaisher subscribed.Sep 3 2015, 6:54 AM

Krinkle edited projects, added MediaWiki-Documentation; removed Architecture.Jan 4 2018, 12:28 AM

Quiddity subscribed.Sep 9 2018, 12:12 AM

Krinkle added a project: TechCom.Sep 9 2018, 5:55 PM

• kchapman assigned this task to Krinkle.Sep 25 2018, 11:32 PM

• kchapman moved this task from Inbox to Backlog on the TechCom board.

Krinkle added a project: Performance-Team.Sep 28 2018, 10:55 PM

• Imarlier moved this task from Inbox, needs triage to To-do: Goals, prioritized next 4 Quarters on the Performance-Team board.Oct 1 2018, 8:14 PM

Krinkle triaged this task as Low priority.Oct 11 2018, 1:21 AM

Change 467138 had a related patch set uploaded (by Krinkle; owner: MGChecker):
[mediawiki/core@master] docs: Remove outdated information from globals.txt

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

gerritbot added a project: Patch-For-Review.Oct 14 2018, 7:13 PM

Change 467138 merged by jenkins-bot:
[mediawiki/core@master] docs: Remove outdated information from globals.txt

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

ReleaseTaggerBot added a project: MW-1.32-notes (WMF-deploy-2018-10-16 (1.32.0-wmf.26)).Oct 14 2018, 8:00 PM

Krinkle removed projects: MW-1.32-notes (WMF-deploy-2018-10-16 (1.32.0-wmf.26)), Patch-For-Review.Oct 28 2018, 10:55 PM

Krinkle removed Krinkle as the assignee of this task.Feb 17 2019, 1:10 AM

Krinkle renamed this task from Replace docs/design.txt with a reasonably complete summary of mw:Architectural_guidelines to Replace docs/design.txt with a reasonably complete summary of how MW works.Feb 20 2019, 9:54 PM

Krinkle updated the task description. (Show Details)

• Gilles moved this task from To-do: Goals, prioritized next 4 Quarters to Radar on the Performance-Team board.Oct 14 2020, 9:10 PM

• Gilles edited projects, added Performance-Team (Radar); removed Performance-Team.

No clear owner any more.

Krinkle moved this task from Limbo to Watching on the Performance-Team (Radar) board.Jan 26 2021, 4:59 PM

Krinkle removed a project: Performance-Team (Radar).Aug 18 2023, 8:14 PM

Replace docs/design.txt with a reasonably complete summary of how MW worksOpen, LowPublicActions

Description

Details

Related Objects

Event Timeline

Replace docs/design.txt with a reasonably complete summary of how MW works
Open, LowPublic
Actions