Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

everything: misleading names in get-resource-links (isOdd) and copy-pasted JSDoc tool names

オープン 初心者向け
#5,210 コメント 1 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
82/100
issue の種類
バグ
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
typescript

調査の方向性

src/everything/tools/get-resource-links.ts、src/everything/tools/trigger-long-running-operation.ts、docs/features.mdを読みます。以前のPR #4503と#4769は、リファクタリング後のコードのプロトタイプとして説明されています。誤解を招くフラグの名前を変更し、偶数と奇数のIDの対応関係を文書化し、各JSDocのツール名を修正します。フラグがその動作に合致し、対応関係が文書化され、両方のヘッダーが各ファイルで登録されるツールと一致したら完了です。

索引モデルが issue の本文から書いたものです。

説明

chore server-everything v2
Problem

Two small naming slips in the everything server, which people read to learn the protocol:

  • In src/everything/tools/get-resource-links.ts, the flag isOdd is computed as resourceId % 2 === 0, so it is true for even IDs (which get Text resources). The behavior is right; the name says the opposite, and docs/features.md doesn't say which IDs map to which resource type.
  • The JSDoc header in src/everything/tools/get-resource-links.ts names the get-resource-reference tool (copied from its neighbor), and the one in src/everything/tools/trigger-long-running-operation.ts misspells its tool's name.
Expected

Rename the flag (for example to isText), document the even/odd mapping, and have each JSDoc header name the tool its file registers.

Prior work
  • #4503 by @Joosboy
  • #4769 by @simpleqt

The PR(s) above targeted the pre-refactor code and are closed as part of the backlog triage in #4875; this issue is where the work continues, with the PR(s) as a prototype. Thank you to their authors.

主要言語
TypeScript
スター
91.4k
フォーク
11.8k
平均マージ
7時間 36分
マージ済み PR(30日)
126

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

modelcontextprotocol/servers のほかの issue

modelcontextprotocol/servers の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。