Page MenuHomePhabricator
Create Task
Maniphest T363905

Uninstall jsduck and related material from CI images etc., once it's no longer needed
Closed, ResolvedPublic
Actions

Description

Search

  • CI images
    • Quibble images
    • Node images
  • MW-Vagrant
  • LibUp

Details

Related Changes in Gerrit:
SubjectAuthorRepoBranchLines +/-
jjb: Update node and Quibble jobs for the jsduck removalJforresterintegration/configmaster+62 -62
Docker: [quibble-bookworm, node24-test, node26-test] Drop jsduck etc.Jforresterintegration/configmaster+103 -28
Customize query in gerrit

Related Objects
Search...

StatusSubtypeAssignedTask
 ResolvedJdforrester-WMFT363905 Uninstall jsduck and related material from CI images etc., once it's no longer needed
 ResolvedapaskulinT138401 Replace jsduck with JSDoc3 across all Wikimedia code bases
 Resolved• JhernandezT146917 [Spike, 4hrs] What does jsdoc not support that jsduck does
 DuplicateNoneT153890 [2 hours] Compare the features offered by jsduck and jsdoc
 ResolvedKrinkleT185397 Replace jsduck with JSDoc3 in OOjs
 ResolvedapaskulinT187672 Release jsdoc-wmf-theme 1.0 (Wikimedia theme for JSDoc3)
 OpenNoneT207383 Inherited methods and members of mixins are missing
 ResolvedEsandersT262403 jsdoc-wmf-theme: Search is completely broken
 ResolvedEsandersT337575 jsodoc-wmf-theme: Params table is not very legible
 ResolvedBUG REPORTKrinkleT315103 Menu on https://doc.wikimedia.org/oojs/master/ non functional on Firefox mobile
 ResolvedJdlrobsonT188261 [MobileFrontend] Replace JSDuck with JSDoc
 DuplicateNoneT188262 Remove JSDuck
 DuplicateNoneT188263 Fix JSDoc offenders
 DuplicateNoneT188264 Add JSDoc configuration file
 Resolved• nrayT239258 Migrate JavaScript API documentation from jsduck to JSDoc
 ResolvedJdforrester-WMFT250843 Replace jsduck with JSDoc3 in VisualEditor
 Resolved• matmarexT185396 Replace jsduck with JSDoc3 in OOUI
 DeclinedNoneT156469 jsduck doesn't support ES6
 ResolvedcscottT184573 Re-enable documentation for ES6-using classes
 ResolvedTheDJT284766 Document process to add jsdoc to a repository
 Resolved• SamwilsonT307415 Add JSDoc configuration to WikiEditor
 ResolvedNoneT342864 Replace jsduck with JSDoc3 in Kartographer
 OpenNoneT342905 Replace jsduck with JSDoc3 in Wikibase
 DeclinedNoneT351764 Preserve existing JSDuck documentation on docs.wikimedia.org
 ResolvedapaskulinT352308 Port remaining files to jsdoc in MediaWiki core
 ResolvedKrinkleT353418 Fix broken link in mw.requestIdleCallback docs
 Resolved• matmarexT353540 Make oojs-ui the primary source of OOUI docs
 ResolvedapaskulinT353560 Fix on-wiki links to MediaWiki JSDoc site
 DeclinedBUG REPORTJdlrobsonT354716 Cryptic warnings inside publish.js on valid JSDoc
 ResolvedapaskulinT356546 Update the MediaWiki core JSDoc homepage
 ResolvedegardnerT352320 Redirect existing hyperlinks to old docs
 OpenNoneT365114 Replace jsduck with JSDoc3 in UploadWizard
 OpenNoneT366230 Mass refactoring of JSDuck-only tags
 OpenNoneT366264 Replace jsduck with JSDoc3 in Translate
 ResolvedNovem_LinguaeT366789 Replace jsduck with JSDoc3 in CollaborationKit
 ResolvedNovem_LinguaeT367507 Replace jsduck with JSDoc3 in GuidedTour
 ResolvedNovem_LinguaeT368082 Decide on the standard name for a JSDoc settings file: .jsdoc.json or jsdoc.json
 ResolvedsanthoshT391703 Replace jsduck with JSDoc in CX Server
 OpenNoneT391704 Replace jsduck with JSDoc in DonationInterface
 DuplicateNoneT391705 Replace jsduck with JSDoc in ArticleCreationWorkflow
 OpenNoneT391706 Replace jsduck with JSDoc (or just drop it) in remaining extensions, skins, etc.
 OpenNoneT379692 Migrate ArticleCreationWorkflow from JSDuck to JSDoc

Event Timeline

Jdforrester-WMF created this task.May 1 2024, 10:48 AM
Restricted Application added a subscriber: Aklapper. · View Herald TranscriptMay 1 2024, 10:48 AM
Jdforrester-WMF added a subtask: T138401: Replace jsduck with JSDoc3 across all Wikimedia code bases.May 1 2024, 10:48 AM
Jdforrester-WMF renamed this task from Uninstall jsduck and related material from CI images, once it's no longer needed to Uninstall jsduck and related material from CI images etc., once it's no longer needed.May 1 2024, 10:51 AM
Jdforrester-WMF added a project: MediaWiki-Vagrant.
Jdforrester-WMF updated the task description. (Show Details)
hashar subscribed.May 6 2024, 6:57 AM

How do we deal with jsduck still being used in the release branches?

Jdforrester-WMF added a comment.May 7 2024, 6:54 AM
In T363905#9773574, @hashar wrote:

How do we deal with jsduck still being used in the release branches?

In general, jsduck is triggered via the CI job template extension-javascript-documentation which isn't defined for release branches, and e.g. its sub-job mwext-node18-docs-publish only runs for the master branch – so, once we've finally eliminated it from all master branches (still a work in progress!) this should suffice.

taavi added a project: LibUp.May 7 2024, 2:01 PM
taavi updated the task description. (Show Details)
hashar added a comment.May 13 2024, 8:29 AM

@Jdforrester-WMF sounds good thanks!!

apaskulin closed subtask T138401: Replace jsduck with JSDoc3 across all Wikimedia code bases as Resolved.Nov 12 2024, 11:36 PM
Jdforrester-WMF added a comment.Nov 13 2024, 2:53 PM

Note: Even though T138401 has been marked Resolved, it's not yet done. There are a bunch of production repos that still need to migrate — Wikispeech (T379691), ArticleCreationWorkflow (T379692), and DonationInterface (T379693) — before we can drop the support from CI. :-(

Novem_Linguae changed the task status from Open to Stalled.Nov 13 2024, 2:57 PM
hashar added a comment.Jun 24 2025, 7:55 AM

As part of the Continuous-Integration-Infrastructure (Zuul upgrade) we are overhauling all jobs and support for jsduck will be removed entirely. I expect the migration to happen after the summer of 2025.

hashar unsubscribed.Nov 12 2025, 8:55 AM
santhosh closed subtask T391703: Replace jsduck with JSDoc in CX Server as Resolved.May 19 2026, 5:49 AM
Jdforrester-WMF added a subtask: T379692: Migrate ArticleCreationWorkflow from JSDuck to JSDoc.Tue, Sep 15, 8:32 PM
gerritbot added a comment.Tue, Sep 15, 8:42 PM

Change #1342045 had a related patch set uploaded (by Jforrester; author: Jforrester):

[integration/config@master] Docker: [quibble-bookworm, node24-test, node26-test] Drop jsduck and Ruby supports

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

gerritbot added a project: Patch-For-Review.Tue, Sep 15, 8:42 PM
gerritbot added a comment.Tue, Sep 15, 8:45 PM

Change #1342045 merged by jenkins-bot:

[integration/config@master] Docker: [quibble-bookworm, node24-test, node26-test] Drop jsduck etc.

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

Stashbot added a comment.Tue, Sep 15, 8:46 PM

Mentioned in SAL (#wikimedia-releng) [2026-09-15T20:46:42Z] <James_F> Docker: [quibble-bookworm, node24-test, node26-test] Drop jsduck etc. for T363905

Jdforrester-WMF updated the task description. (Show Details)Tue, Sep 15, 8:46 PM
Jdforrester-WMF updated the task description. (Show Details)
gerritbot added a comment.Tue, Sep 15, 9:17 PM

Change #1342051 had a related patch set uploaded (by Jforrester; author: Jforrester):

[integration/config@master] jjb: Update node and Quibble jobs for the jsduck removal

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

Jdforrester-WMF removed a project: LibUp.Tue, Sep 15, 9:18 PM
Jdforrester-WMF updated the task description. (Show Details)
gerritbot added a comment.Tue, Sep 15, 9:19 PM

Change #1342051 merged by jenkins-bot:

[integration/config@master] jjb: Update node and Quibble jobs for the jsduck removal

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

Jdforrester-WMF closed this task as Resolved.Tue, Sep 15, 9:23 PM
Jdforrester-WMF claimed this task.

Let's call this done, and the Vagrant concern can be removed if/when someone cares there.

Maintenance_bot removed a project: Patch-For-Review.Tue, Sep 15, 9:30 PM
Content licensed under Creative Commons Attribution-ShareAlike (CC BY-SA) 4.0 unless otherwise noted; code licensed under GNU General Public License (GPL) 2.0 or later and other open source licenses. By using this site, you agree to the Terms of Use, Privacy Policy, and Code of Conduct. · Wikimedia Foundation · Privacy Policy · Code of Conduct · Terms of Use · Disclaimer · CC-BY-SA · GPL · Credits