Page MenuHomePhabricator
Create Task
Maniphest T366264

Replace jsduck with JSDoc3 in Translate
Open, MediumPublic2 Estimated Story Points
Actions

Description

  • eliminate 8 excludes statements in jsdoc.json (and the errors causing them to be excluded)
  • fix npm run doc warnings
    • The @inheritdoc tag does not permit a value; the value will be ignored. File: LanguagesMultiselectWidget.js x10
    • WARNING: No contribution link found (in package.json>repository.url, or jsdoc.json>templates.wmf.repository)
  • convert README to README.md (markdown), so that /doc/index.html is readable
  • check for missing classes and methods
    • RenameDropdown methods
    • GroupSynchronization class & methods
    • more?
  • check for and fix doc-related linter errors. (add npm run lint to facilitate this)

Details

SubjectRepoBranchLines +/-
Revert "JSDoc: initial setup"mediawiki/extensions/Translatemaster+0 -576
JSDoc: add class GroupSynchronizationmediawiki/extensions/Translatemaster+51 -0
JSDoc: initial setupmediawiki/extensions/Translatemaster+576 -0
JSDoc: get missing RenameDropdown methods to show up in /docs/mediawiki/extensions/Translatemaster+7 -0
JSDoc: fix linter warningsmediawiki/extensions/Translatemaster+3 -1
Customize query in gerrit

Related Objects
Search...

Event Timeline

Novem_Linguae created this task.Thu, May 30, 10:44 AM
Restricted Application added a subscriber: Aklapper. · View Herald TranscriptThu, May 30, 10:44 AM
Novem_Linguae added a parent task: T138401: Replace jsduck with JSDoc3 across all Wikimedia code bases.Thu, May 30, 10:45 AM
Novem_Linguae mentioned this in T138401: Replace jsduck with JSDoc3 across all Wikimedia code bases.
Novem_Linguae updated the task description. (Show Details)Thu, May 30, 10:48 AM
Novem_Linguae updated the task description. (Show Details)
gerritbot added a comment.Thu, May 30, 11:08 AM

Change #1034111 had a related patch set uploaded (by Novem Linguae; author: Novem Linguae):

[mediawiki/extensions/Translate@master] JSDoc: initial setup

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

gerritbot added a project: Patch-For-Review.Thu, May 30, 11:08 AM
gerritbot added a comment.Thu, May 30, 12:56 PM

Change #1037534 had a related patch set uploaded (by Novem Linguae; author: Novem Linguae):

[mediawiki/extensions/Translate@master] JSDoc: fix linter warnings

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

Novem_Linguae updated the task description. (Show Details)Thu, May 30, 12:56 PM
gerritbot added a comment.Thu, May 30, 1:02 PM

Change #1037537 had a related patch set uploaded (by Novem Linguae; author: Novem Linguae):

[mediawiki/extensions/Translate@master] JSDoc: get missing RenameDropdown methods to show up in /docs/

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

gerritbot added a comment.Thu, May 30, 1:25 PM

Change #1037540 had a related patch set uploaded (by Novem Linguae; author: Novem Linguae):

[mediawiki/extensions/Translate@master] JSDoc: add class GroupSynchronization

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

Novem_Linguae updated the task description. (Show Details)Thu, May 30, 1:26 PM
gerritbot added a comment.Thu, May 30, 6:26 PM

Change #1034111 merged by jenkins-bot:

[mediawiki/extensions/Translate@master] JSDoc: initial setup

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

ReleaseTaggerBot added a project: MW-1.43-notes (1.43.0-wmf.8; 2024-06-04).Thu, May 30, 7:00 PM
abi_ assigned this task to Novem_Linguae.Fri, May 31, 10:50 AM
abi_ triaged this task as Medium priority.
abi_ added projects: Language-Team (Language-2024-April-June), Localization Infrastructure FY2023-24, Unplanned-Sprint-Work.
abi_ moved this task from Quarter Backlog to In Progress on the Language-Team (Language-2024-April-June) board.
abi_ added a project: MediaWiki-extensions-Translate.
abi_ set the point value for this task to 2.
Nikerabbit moved this task from Backlog to Support (LM) on the Localization Infrastructure FY2023-24 board.Tue, Jun 4, 1:37 PM
gerritbot added a comment.Tue, Jun 4, 6:48 PM

Change #1037534 merged by jenkins-bot:

[mediawiki/extensions/Translate@master] JSDoc: fix linter warnings

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

ReleaseTaggerBot edited projects, added MW-1.43-notes (1.43.0-wmf.9; 2024-06-11); removed MW-1.43-notes (1.43.0-wmf.8; 2024-06-04).Tue, Jun 4, 7:00 PM
Nikerabbit moved this task from Backlog to maintenance and operational issues on the MediaWiki-extensions-Translate board.Thu, Jun 6, 8:36 AM
gerritbot added a comment.Sat, Jun 8, 11:19 PM

Change #1037540 abandoned by Novem Linguae:

[mediawiki/extensions/Translate@master] JSDoc: add class GroupSynchronization

Reason:

I've been informed that we should only set up JSDoc sites for extensions that previously had JSDuck. This one did not. Going to save reviewers some time and abandon/rollback my patches related to JSDoc for Extension:Translate.

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

gerritbot added a comment.Sat, Jun 8, 11:19 PM

Change #1037537 abandoned by Novem Linguae:

[mediawiki/extensions/Translate@master] JSDoc: get missing RenameDropdown methods to show up in /docs/

Reason:

I've been informed that we should only set up JSDoc sites for extensions that previously had JSDuck. This one did not. Going to save reviewers some time and abandon/rollback my patches related to JSDoc for Extension:Translate.

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

gerritbot added a comment.Sat, Jun 8, 11:25 PM

Change #1040568 had a related patch set uploaded (by Novem Linguae; author: Novem Linguae):

[mediawiki/extensions/Translate@master] Revert "JSDoc: initial setup"

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

gerritbot added a comment.Tue, Jun 25, 1:31 PM

Change #1040568 abandoned by Novem Linguae:

[mediawiki/extensions/Translate@master] Revert "JSDoc: initial setup"

Reason:

Team wants to keep JSDoc

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

Novem_Linguae removed Novem_Linguae as the assignee of this task.Tue, Jun 25, 1:32 PM
Novem_Linguae updated the task description. (Show Details)
Maintenance_bot removed a project: Patch-For-Review.Tue, Jun 25, 2:31 PM
Nikerabbit removed projects: Unplanned-Sprint-Work, Language-Team (Language-2024-April-June).Thu, Jun 27, 7:42 AM
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