Reason
- two of its authors are in favor of archiving in T366815
- is not WMF-deployed
- is not installed on any known wikis or wikifarms
- maintenance burden to deal with hard deprecations, JSDuck to JSDoc conversion, etc.
Extra steps
- maybe merge my 6 patches I just wrote that fix the extension, so that they're in the history? :) gerrit:1045635 is the first patch in the patch chain.
- this extension has documentation deployed to doc.wikimedia.org, so probably need to patch/delete this: https://github.com/wikimedia/integration-docroot/blob/7f59f4909f0eca7c6d1906ca367c24c491c945da/org/wikimedia/doc/opensource.yaml#L811-L815
Regular steps
- This task
- Add maintainers of that extension/skin as subscribers to this task (if they have no apparent Phabricator account, notify them on-wiki or via email if possible and note it here).
- Add Phabricator project <#ProjectX> as a tag for this task, and remove MediaWiki-extensions-Other/Other-skins as appropriate.
- On-wiki documentation
- Archive documentation on mediawiki.org (provide URL): replace page contents with {{Archived extension|last revision id before archiving|task=T######}} (for extensions)/{{Archived skin|last revision|task=T######}} (for skins); replace T###### with this task's number.
- If documentation page was translatable, remove <translate>, visit Special:PageTranslation, and click "remove from translation" (if you don't have the translation administrator right, ask a user who does).
- Update Wikidata item (provide URL) associated with documentation page
- add statement Abandonware (Q281039) to instance of (P31) together with qualifier start time (P580) = the YYYY-MM-DD date that you decided to archive extension/skin (generally per edit history)
- add qualifier end time (P582) = the YYYY-MM-DD (same date as above) to instance of (P31) = MediaWiki extension (Q6805426)/MediaWiki skin (Q21996535)
- Phabricator
- Mark all Phabricator tasks for the extension/skin either Declined or Invalid. Add a comment pointing to this task when doing so for reference.
- Archive Phabricator project <#ProjectX> for the extension/skin.
- Edit Phabricator project <#ProjectX> description for the extension/skin with a link to this ticket.
- Translatewiki.net/translations
-
If the extension is deployed on Wikimedia sites, but it is known that it's not going to receive significant feature updates or deployed to new wikis, make sure that its project ids (usually "ext-extensionname") appear in the groups/MediaWiki/WikimediaLegacyAgg.yaml file in the translatewiki Gerrit repository and not in WikimediaMainAgg.yaml, WikimediaAdvancedAgg.yaml, etc. (If it also has an api group, it should remain in WikimediaTechnicalAgg.yaml). -
If the extension is no longer deployed on Wikimedia sites, remove it from all Wikimedia*Agg.yaml. (If it was ever deployed, by this time, it's most likely in WikimediaLegacyAgg.yaml or WikimediaTechnicalAgg.yaml.) - If the extension is going to be completely archived and no longer developed, remove it completely from translatewiki.net by making sure that its project IDs don't appear in any of the following files:
-
- Configuration/tests/integrations/etc.
- Remove tests in integration/config (zuul/layout.yaml).
-
Remove manifest/other references from mediawiki/vagrant if they exist. - Remove from https://doc.wikimedia.org/cover-extensions/ if present (requires Continuous-Integration-Infrastructure shell user to delete directly from the server).
- Repositories
- Empty repository, leaving only the README indicating the repo is archived, and referring to this task by URL.
- Remove from mediawiki/extensions (along with in .gitmodules).
- Mark the repository read-only in Gerrit (also edit description to prepend "[ARCHIVED]" and a reference to this task, remove all access lists and reparent on All-Archived-Project): https://gerrit.wikimedia.org/r/admin/repos/mediawiki/extensions/CollaborationKit,general
- Deactivate the Diffusion repository for the extension/skin: (provide the Diffusion repository callsign or URL).
- Delete the GitHub mirror: (provide GitHub repository URL).