Uninstall jsduck and related material from CI images etc., once it's no longer needed
Open, Stalled, Needs TriagePublic
Actions

Assigned To

None

Authored By

	Jdforrester-WMF
	May 1 2024, 10:48 AM

Related Objects
Search...

Status	Subtype	Assigned	Task
Stalled		None	T363905 Uninstall jsduck and related material from CI images etc., once it's no longer needed
Resolved		apaskulin	T138401 Replace jsduck with JSDoc3 across all Wikimedia code bases
Resolved		• Jhernandez	T146917 [Spike, 4hrs] What does jsdoc not support that jsduck does
Duplicate		None	T153890 [2 hours] Compare the features offered by jsduck and jsdoc
Resolved		Krinkle	T185397 Replace jsduck with JSDoc3 in OOjs
Resolved		apaskulin	T187672 Release jsdoc-wmf-theme 1.0 (Wikimedia theme for JSDoc3)
Open		None	T207383 Inherited methods and members of mixins are missing
Resolved		Esanders	T262403 jsdoc-wmf-theme: Search is completely broken
Resolved		Esanders	T337575 jsodoc-wmf-theme: Params table is not very legible
Resolved	BUG REPORT	Krinkle	T315103 Menu on https://doc.wikimedia.org/oojs/master/ non functional on Firefox mobile
Resolved		Jdlrobson	T188261 [MobileFrontend] Replace JSDuck with JSDoc
Duplicate		None	T188262 Remove JSDuck
Duplicate		None	T188263 Fix JSDoc offenders
Duplicate		None	T188264 Add JSDoc configuration file
Resolved		• nray	T239258 Migrate JavaScript API documentation from jsduck to JSDoc
Resolved		Jdforrester-WMF	T250843 Replace jsduck with JSDoc3 in VisualEditor
Resolved		matmarex	T185396 Replace jsduck with JSDoc3 in OOUI
Declined		None	T156469 jsduck doesn't support ES6
Resolved		cscott	T184573 Re-enable documentation for ES6-using classes
Resolved		TheDJ	T284766 Document process to add jsdoc to a repository
Resolved		Samwilson	T307415 Add JSDoc configuration to WikiEditor
Resolved		None	T342864 Replace jsduck with JSDoc3 in Kartographer
Open		None	T342905 Replace jsduck with JSDoc3 in Wikibase
Declined		None	T351764 Preserve existing JSDuck documentation on docs.wikimedia.org
Resolved		apaskulin	T352308 Port remaining files to jsdoc in MediaWiki core
Resolved		Krinkle	T353418 Fix broken link in mw.requestIdleCallback docs
Resolved		matmarex	T353540 Make oojs-ui the primary source of OOUI docs
Resolved		apaskulin	T353560 Fix on-wiki links to MediaWiki JSDoc site
Declined	BUG REPORT	Jdlrobson	T354716 Cryptic warnings inside publish.js on valid JSDoc
Resolved		apaskulin	T356546 Update the MediaWiki core JSDoc homepage
Resolved		egardner	T352320 Redirect existing hyperlinks to old docs
Open		None	T365114 Replace jsduck with JSDoc3 in UploadWizard
Open		None	T366230 Mass refactoring of JSDuck-only tags
Open		None	T366264 Replace jsduck with JSDoc3 in Translate
Resolved		Novem_Linguae	T366789 Replace jsduck with JSDoc3 in CollaborationKit
Resolved		Novem_Linguae	T367507 Replace jsduck with JSDoc3 in GuidedTour
Resolved		Novem_Linguae	T368082 Decide on the standard name for a JSDoc settings file: .jsdoc.json or jsdoc.json
Open		None	T391703 Replace jsduck with JSDoc in CX Server
Open		None	T391704 Replace jsduck with JSDoc in DonationInterface
Duplicate		None	T391705 Replace jsduck with JSDoc in ArticleCreationWorkflow
Open		None	T391706 Replace jsduck with JSDoc (or just drop it) in remaining extensions, skins, etc.

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)

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

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)

@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

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

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

Uninstall jsduck and related material from CI images etc., once it's no longer neededOpen, Stalled, Needs TriagePublicActions

Description

Related ObjectsSearch...

Event Timeline

Uninstall jsduck and related material from CI images etc., once it's no longer needed
Open, Stalled, Needs TriagePublic
Actions

Related Objects
Search...