Page MenuHomePhabricator

[EPIC] Make wikitech more friendly for the multiple audiences it supports
Open, NormalPublic

Description

The wikitech.wikimedia.org wiki is the home wiki for several technical projects of the Wikimedia Foundation and the larger Wikimedia technical community. According to the current landing page it supports documentation of:

  • production servers and services
  • the Wikimedia Labs virtual machine hosting environment
  • the Tool Labs environment

In addition to these 3 areas, Wikitech is also home to WMF deployment documentation (how to and schedules), OpenStackManager pages for managing Labs instances, documentation on the care and feeding of the Beta Cluster (Deployment-prep Labs project) that is used for integration testing, documentation on additional projects other than Tools and Deployment-prep, documentation on some bots and tools that run in the Tool Labs project, ... the list goes on.

In the past the idea of splitting wikitech into multiple wikis to separate audiences has come up (e.g. T70818: Investigate the creation of a wiki for the dev community that is organizing around Labs). There are pros and cons to adding more wikis but the current consensus seems to be that we should try harder to make a single wiki work before we take the more drastic step of creating yet another wiki.

Key problems with the mixed usage of the wiki:

  • Search results can be ambiguous for various audiences. This is especially pronounced when searching for terms like puppet that are commonly used in Labs hostnames surfaced in the Nova Resource namespace
  • Name collision in the main namespace for terms used by multiple audiences such as database.
  • User rights on Wikitech are tied to technical rights with the infrastructure, and are delicate to delegate to the community {{cn}}
  • No clear location for Tool developers to document their projects.
  • Quite a bit of content that is only of historical interest: Category:Archive, Category:Old_documentation, namespace Obsolete.

Event Timeline

bd808 created this task.Jan 12 2016, 10:04 PM
bd808 raised the priority of this task from to Needs Triage.
bd808 updated the task description. (Show Details)
bd808 added a subscriber: bd808.
Restricted Application added a project: Cloud-Services. · View Herald TranscriptJan 12 2016, 10:04 PM
Restricted Application added subscribers: StudiesWorld, Aklapper. · View Herald Transcript
greg awarded a token.Jan 12 2016, 11:20 PM
Bene awarded a token.Jan 13 2016, 1:15 PM
Luke081515 added a subscriber: Luke081515.
Qgil added a subscriber: Qgil.
Qgil moved this task from To triage to Team radar on the Developer-Advocacy board.Feb 3 2016, 8:51 AM
DannyH added a subscriber: DannyH.Mar 2 2016, 10:18 PM
bd808 triaged this task as Normal priority.Mar 25 2016, 12:41 AM
Qgil added a comment.Oct 27 2016, 1:35 PM

Would this task be a good topic for the Wikimedia-Developer-Summit (2017) ? If so, the deadline to submit new proposals is next Monday, October 31: https://www.mediawiki.org/wiki/Wikimedia_Developer_Summit/Call_for_participation

Restricted Application added a subscriber: Liuxinyu970226. · View Herald TranscriptJul 11 2019, 3:49 PM