Skip to content

feat: Add a basic JSdoc#5

Open
Derugon wants to merge 5 commits into
wikimedia-gadgets:mainfrom
Derugon:main
Open

feat: Add a basic JSdoc#5
Derugon wants to merge 5 commits into
wikimedia-gadgets:mainfrom
Derugon:main

Conversation

@Derugon

@Derugon Derugon commented Dec 24, 2025

Copy link
Copy Markdown
Collaborator

Generate JSdoc comments along with the module interfaces and parameters, to include information that can not be expressed with TS types.

In this PR, this includes:

  • default parameter values,
  • sensitive parameters,
  • deprecated modules and parameters,
  • online documentation links.

This does not include:

  • which parameters can be used with GET and which ones with POST,
  • required read/write rights,
  • deprecated or internal parameter values,
  • value bounds, such as byte limits for strings or min/max values for numbers.

(implementation based on wikimedia-gadgets/types-mediawiki#41)

to reduce code duplication.
Including:
- base description (as JSdoc-friendly markdown),
- default value,
- whether the parameter is sensitive,
- `@private` annotation,
- `@deprecated` annotation.
Including:
- base description,
- `@see` link annotations,
- `@private` annotation,
- `@deprecated` annotation.
@Derugon Derugon changed the title Add a basic JSdoc feat: Add a basic JSdoc Dec 24, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant