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
- 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.)
- Phase 2: Page updates
- Complete subtasks of this task (except T344204)
- Complete page edits listed below
- Phase 3: Update landing page
- Complete T344204: Update Project:Help on mediawiki.org
- Link to landing page from mediawiki.org main 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