docs(network): TSDoc says ICE_SERVERS defaults to an empty list, the code uses public STUN servers

Offen Anfängerfreundlich
#509 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 1 Tag

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
1/5
Geschätzter Aufwand
Unter einer Stunde
Anfängerfreundlichkeit
88/100
Issue-Typ
Dokumentation
Klarheit
Klar beschrieben
Aktivitätsstatus
Aktiv
Tech-Stack
typescript

Rechercherichtung

Lies modules/network/src/shared/config.network.ts:55 und vergleiche den Decorator mit dem TSDoc; prüfe docs/docs/network/index.mdx:105 auf den dokumentierten Standardwert. Aktualisiere den TSDoc, damit dort der öffentliche STUN-Server-Standardwert angegeben und erklärt wird, dass ICE_SERVERS= mit einer leeren Liste deaktiviert. Fertig, wenn die API-Referenz mit dem Code übereinstimmt und die Deaktivierung dokumentiert.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

documentation good first issue modules:network
What is the type of issue?

Documentation is incorrect

What is the issue?

The TSDoc says @default [], but the decorator uses DEFAULT_NANOFORGE_ICE_SERVERS (7 public STUN servers). A user who wants no third-party STUN servers (privacy, offline LAN) is told the wrong default by the API reference. docs/docs/network/index.mdx:105 gives the right default.

Evidence:

 * @default []
@Default(DEFAULT_NANOFORGE_ICE_SERVERS)

Suggested fix: Document the real default and how to opt out (ICE_SERVERS= → []).

Found during a code audit of main at be72076.

Where did you find it?
Vorherrschende Sprache
TypeScript
Sterne
7
Forks
2
Ø Merge
1 T. 17 Std.
Gemergte PRs (30 T.)
17

Entwicklungsumgebung

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus NanoForge-dev/Engine

Alle Issues in NanoForge-dev/Engine

Ähnliche Issues

Weitere Issues zu TypeScript

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.