codeforpdx / codeforpdx/PASS

Bug: No existing ESLint rules for unused @typedefs in project

Open
#471 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

bug
Dominant language
JavaScript
Stars
38
Forks
23
Avg merge
11m
Merged PRs (30d)
4

Description

Bug Description:

Currently, we're utilizing eslint-plugin-jsdoc for our linting when it comes to JSDoc. However, it does not cover everything such as picking up unused @typedefs. At the moment, the plugin does not have rules for that like it does with no-unused-vars within its configuration, thus people had to manually remove unused @typedefs when found.

Possible Solution (optional):
  1. Found another plugin or library which assists with existing ESLint rules.
  2. Create a custom rule for unused @typedefs
  3. Change syntax for importing typedefs similar to that of importing variables/libraries from other files (See screenshots below)
Screen Shot 2023-10-21 at 15 40 43 Screen Shot 2023-10-21 at 15 44 44

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the project's eslint-plugin-jsdoc configuration and the available ESLint rules for unused @typedef declarations. Compare an existing plugin or library with the custom-rule and import-syntax alternatives described in the issue. Done means the project can reliably identify unused @typedefs without manual removal.

Written by the indexing model from the issue text.

Assessment

Tech stack
eslint, javascript
Domain
tooling
Issue type
Bug
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.