Menu ▾ ▴

#511 Docs: fill 13 empty-description JSDoc blocks in Style/shared_validation.js

open
nobody
2026-10-03
2026-10-03
Anonymous
No

Originally created by: Redo-San

These blocks in Style/shared_validation.js have a blank description line and a bare @param with no type or text — the signatures are already there, only the prose is missing:

lines 76, 177, 238, 251, 268, 302, 389, 409, 417, 442, 463, 473, 499

(line 177 is matchesMagicBytes; line 389 has two bare params.)

They currently look like:

/**
 *

 * @param file
 */

Scope is deliberately this one file — the repo has 711 such blocks in total.

Acceptance criteria

  • [ ] rg -U '/\*\*\r?\n\s*\*\r?\n\s*\* @param' Style/shared_validation.js → 0 matches.
  • [ ] npm run lint and npm run stylelint pass.
  • [ ] node --test cli/tests/validation_test.js passes.

Discussion


Log in to post a comment.