Page MenuHomePhabricator

Update mediawiki.org project pages
Open, Stalled, MediumPublic

Description

Lead: @apaskulin
Advising: @KBach

This is a parent task for a set of updates planned for July-September 2023.

Goals

Create a shared understanding of the state of mediawiki.org between contributors.

  • The pages in the Project namespace on mediawiki.org are up to date.
  • A person wanting to contribute to mediawiki.org can understand how the site is currently organized.

Priority

Aligns with WE3.2: Good documentation is a key component of being able to contribute code effectively. By understanding the current state of the docs, we can identify areas for improvement that will help improve the experience of contributors.

Stakeholders

  • mediawiki.org contributors, including admins and other contributors with advanced permissions

Since this project aims to document the existing state of mediawiki.org, I don’t expect to need extensive consultation, but feedback on and help with these plans is always welcome.

Project plan

  • Phase 1: Determine scope
    • Audit pages in the Project namespace, and identify rough todos. (I reviewed all pages in the Project namespace, triaged them by category, marked some as historical or for deletion, and identified needed updates on pages related to mediawiki.org.)
      • Publish a condensed version of this audit to this task
    • Review open tasks in MediaWiki-Documentation and Documentation, and identify related requests. (I didn't find anything related to project pages, but please let me know if I missed something.)
    • Define a scope for the rest of the project, and update this project plan
  • Phase 2: Page updates
    • Complete subtasks of this task (except T344204)
    • Complete page edits listed below
  • Phase 3: Update landing page

Pages to edit

  • Project:Tasks – missing some descriptions, wrong translate link? outdated banner?
  • Project:Namespaces – add intro, remove placeholders ("stuff", "..."), fix title case, add API to first section
  • Project:Copyrights – acronyms, could change to allow edits from autoconfirmed users
  • Project:Manual – API docs go in API namespace, fix section linking to Language Policy
  • Project:PD help – possible to remove acronym? replace "normal"
  • Project:Protected titles – refocus on mediawiki.org instead of generic instructions, move generic content to a help page if necessary, fix title case
  • Project:PD help/Copying – fix "yet", test instructions, is this a manual list?
  • Project:File copyright tags – tone fixes
  • Project:PD help/export – refocus on export process
  • Project:Protected page – possible to make plural? sync with interface message
  • Project:Image policy – link fixes, better heading than "General"
  • Project:Deliberately unused templates – why is this outdated?

Content audit summary

Condensed audit of pages in the Project namespace on medawiki.org

# Related to mediawiki.org
https://www.mediawiki.org/wiki/Project:About
https://www.mediawiki.org/wiki/Project:Bots
https://www.mediawiki.org/wiki/Project:Categories (discussion)
https://www.mediawiki.org/wiki/Project:Copyrights
https://www.mediawiki.org/wiki/Project:Deletion
https://www.mediawiki.org/wiki/Project:Deliberately_unused_templates
https://www.mediawiki.org/wiki/Project:Fair_use_policy
https://www.mediawiki.org/wiki/Project:File_alert_tags
https://www.mediawiki.org/wiki/Project:File_copyright_tags
https://www.mediawiki.org/wiki/Project:Flat_namespace
https://www.mediawiki.org/wiki/Project:General_disclaimer
https://www.mediawiki.org/wiki/Project:Good_page_name
https://www.mediawiki.org/wiki/Project:Help
https://www.mediawiki.org/wiki/Project:Image_policy
https://www.mediawiki.org/wiki/Project:Language_policy
https://www.mediawiki.org/wiki/Project:Language_policy/Migration_list
https://www.mediawiki.org/wiki/Project:Manual
https://www.mediawiki.org/wiki/Project:Mastodon
https://www.mediawiki.org/wiki/Project:MediaWiki_is_not_Wikipedia
https://www.mediawiki.org/wiki/Project:Namespaces
https://www.mediawiki.org/wiki/Project:PD_help
https://www.mediawiki.org/wiki/Project:PD_help/Copying
https://www.mediawiki.org/wiki/Project:PD_help/Outreachy_(Round_15)
https://www.mediawiki.org/wiki/Project:PD_help/export
https://www.mediawiki.org/wiki/Project:Protected_page
https://www.mediawiki.org/wiki/Project:Protected_titles
https://www.mediawiki.org/wiki/Project:Schools_of_thought_on_deletion
https://www.mediawiki.org/wiki/Project:Sock_puppetry
https://www.mediawiki.org/wiki/Project:Tasks
https://www.mediawiki.org/wiki/Project:Translation

# Tools and processes
https://www.mediawiki.org/wiki/Project:Support_desk (and subpages)
https://www.mediawiki.org/wiki/Project:Sandbox (and subpages)
https://www.mediawiki.org/wiki/Project:Requests (and subpages)
https://www.mediawiki.org/wiki/Project:Tech_News (and subpages)
https://www.mediawiki.org/wiki/Project:Template_in_mediawiki_namespace
https://www.mediawiki.org/wiki/Project:Village_Pump

# Related to other projects
https://www.mediawiki.org/wiki/Project:Pywikibot (and subpages)

# Related to initiatives
https://www.mediawiki.org/wiki/Project:Scripts
https://www.mediawiki.org/wiki/Project:Scripts/Scripts_Inventory
https://www.mediawiki.org/wiki/Project:Update_old_wiki_installations
https://www.mediawiki.org/wiki/Project:WikiFarm

# User groups
https://www.mediawiki.org/wiki/Project:MediaWiki_Farmers_user_group

# Category: user groups
https://www.mediawiki.org/wiki/Project:Account_creators
https://www.mediawiki.org/wiki/Project:Administrators
https://www.mediawiki.org/wiki/Project:Autoconfirmed_users
https://www.mediawiki.org/wiki/Project:Autopatrolled_users
https://www.mediawiki.org/wiki/Project:Bureaucrats
https://www.mediawiki.org/wiki/Project:CheckUser (no cat)
https://www.mediawiki.org/wiki/Project:IP_block_exemption
https://www.mediawiki.org/wiki/Project:Importers
https://www.mediawiki.org/wiki/Project:Interface_administrators
https://www.mediawiki.org/wiki/Project:Transwiki_importers
https://www.mediawiki.org/wiki/Project:Uploaders
https://www.mediawiki.org/wiki/Project:Users

# Disambiguation
https://www.mediawiki.org/wiki/Project:Bot_requests
https://www.mediawiki.org/wiki/Project:Policy

# French
https://www.mediawiki.org/wiki/Project:International_Help_Pages/fr/Contribuer_au_projet
https://www.mediawiki.org/wiki/Project:International_Help_Pages/fr/Mod%C3%A8le_Cadre
https://www.mediawiki.org/wiki/Project:International_Help_Pages/fr/Participants
https://www.mediawiki.org/wiki/Project:International_Help_Pages/fr/Pr%C3%A9sentation
https://www.mediawiki.org/wiki/Project:International_Help_Pages/fr/%C3%80_faire

# Outliers
https://www.mediawiki.org/wiki/Project:AutoWikiBrowser
https://www.mediawiki.org/wiki/Project:Babel
https://www.mediawiki.org/wiki/Project:Defsam
https://www.mediawiki.org/wiki/Project:GUS2Wiki (gadgets)
https://www.mediawiki.org/wiki/Project:Huggle/Config
https://www.mediawiki.org/wiki/Project:Huggle/Config.yaml
https://www.mediawiki.org/wiki/Project:Huggle/Message

# Categories
https://www.mediawiki.org/wiki/Category:Policy
https://www.mediawiki.org/wiki/Category:User groups
https://www.mediawiki.org/wiki/Category:MediaWiki.org_website
https://www.mediawiki.org/wiki/Category:Maintenance
https://www.mediawiki.org/wiki/Category:Images

Event Timeline

apaskulin triaged this task as Medium priority.Jul 12 2023, 5:47 PM
apaskulin moved this task from Backlog to Active projects on the Tech-Docs-Team board.

I kicked off this project this week by triaging the pages in the Project namespace, identifying key pages, content types, categories, and links to landing pages. My rough notes are in this doc and this spreadsheet for now.

In the meantime, I

  • marked as obsolete/historical
    • https://www.mediawiki.org/wiki/Project:New_contributors/Roadmap
    • https://www.mediawiki.org/wiki/Project:Wikimedia_Strategy_2017 (and subpages)
  • moved out of the Project: namespace
    • Project:Sandbox/Scrolless
    • https://www.mediawiki.org/wiki/Project:Calendar/How_to_schedule_an_event/HackathonTips

(sorry, could not comment on the GDoc).

Since setting up the subtasks and project plan for this project, I've resolved T344190: Clarify references to GFDL on mediawiki.org, completed T344188: Clean up references to importing MediaWiki help content from Meta (waiting to resolve once a few deletion notices reach the end of their waiting period), and published a page to address T344200: Document gadget use on mediawiki.org (waiting on some responses to the talk page post before resolving). Next, I'll be focusing on T344192: Disambiguate policies on mediawiki.org and edits to the pages listed in the task description

Project:Deliberately unused templates – why is this outdated?

I seem to have added the outdated tag in May 2020, and I obviously don't know what was going through my mind 3 years ago, but I presume the point I was trying to make was one of:

  1. Someone should go through the templates here and make sure they really still serve a purpose. For instance in years of recent changes patrolling I don't think I've ever seen many of the supposedly-substituted templates used.
  2. Someone should reconsider whether the idea of the page still makes sense - AFAIK nobody is monitoring the unused templates list on MediaWiki.org, which now has several thousand entries. In April and early May 2020 I seem to have done a once-over of the entire MediaWiki.org template namespace and had a bunch of templates deleted.

I seem to have not done either of those things, but I would say the page is still outdated - it reflects what one now-inactive admin wrote in 2007/2008, with a few ad-hoc additions by me in 2020 (which I have no idea why I did, since I must have known that the unused templates report was hopelessly large), and not a systematic review of what templates should remain unused in 2023.

In particular:

No decision has yet been made about whether it is useful to keep these translations, so they may all be deleted in the future.

was written in 2007, and still no decision was ever made AFAIK.

apaskulin changed the task status from Open to Stalled.Mar 19 2024, 6:05 PM
apaskulin moved this task from Active projects to Backlog on the Tech-Docs-Team board.

Stalled due to having to focus on other work