Skip to content

Conversation

@brophdawg11
Copy link
Contributor

Stacked on #10887

Since JSDocs will be the source of our public documentation, this will help ensure that we're not forgetting to document aspects of them. Plenty of room for tweaking of the rules but this should be a good base to get started.

Anything not easily handled via the eslint configs can be checked/asserted in our docs generation script with more granularity to provide another way for CI to detect missing docs.

The code changes in here are mostly just a find/replace for @return -> @returns to align on the canonical JSDoc tag (we were about half and half across the repo).

@mjackson
Copy link
Member

This LGTM. Please go ahead and merge when ready 👍

@brophdawg11 brophdawg11 marked this pull request as ready for review December 16, 2025 17:28
Base automatically changed from brophdawg11/docs-scripts to main December 16, 2025 17:30
@brophdawg11 brophdawg11 force-pushed the brophdawg11/docs-eslint branch from 12b0f08 to 9b91b90 Compare December 16, 2025 17:31
@brophdawg11 brophdawg11 merged commit 728ba5a into main Dec 16, 2025
10 checks passed
@brophdawg11 brophdawg11 deleted the brophdawg11/docs-eslint branch December 16, 2025 17:33
agionoja pushed a commit to agionoja/remix that referenced this pull request Dec 31, 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.

3 participants