Hacktoberfest 2026: die Issues, die Maintainer für den Oktober markiert haben – offen und einsteigerfreundlich. Hacktoberfest-Issues durchsuchen

docs: ROADMAP.md contradicts the stacks, the feeds and a closed issue, and one sentence is broken

Offen
  • Stimmt etwas nicht?
#145 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
4/5
Geschätzter Aufwand
3-5 Tage
Anfängerfreundlichkeit
56/100
Issue-Typ
Dokumentation
Klarheit
Klar beschrieben
Aktivitätsstatus
Aktiv
Tech-Stack
github, javascript
Bereich
devtools, documentation

Rechercherichtung

Read ROADMAP.md, compare its claims with stacks/, site/README.md, site/lib/exports.mjs, and the referenced issues. Rewrite the three sections with current facts, move older Done items to docs/review-ledger.md, and add a check in the monthly re-verify workflow that ROADMAP issue references remain open. Done when ROADMAP has no contradictions and its broken sentence is whole.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

documentation priority: medium

Why it matters

ROADMAP is where CONTRIBUTING and the README send new contributors to find work. #69 fixed an earlier round of the same drift, so a guard is worth adding this time.

Evidence (at 69387df)

  • ROADMAP.md:14: "Starter stacks: audio, a game-jam kit, Unity, Unreal and VR are not covered yet." stacks/3d-third-person-unreal.md exists and is linked from README.md:147 and the homepage.
  • ROADMAP.md:11-13 offers #41 (camera_perspective / grid_dimensions) as "a good first PR"; #41 is closed and camera_perspective is set on 50 entries. The remaining gap is open #98.
  • ROADMAP.md:21-22: the inserted sentence about reverify.yml splits the original one, leaving the fragment "together in mid-2027." dangling on line 22.
  • ROADMAP.md:33-34 says feed.xml is "of recently verified entries"; site/README.md:26-30 and site/lib/exports.mjs:103-109 say feed.xml is new sources by added and reverified.xml is the verified feed.
  • ROADMAP.md:8 names the thin categories as "video, animation and environment"; shaders-vfx (18) is now tied with animation (18), both below environment (20).

Suggested approach

Rewrite the three sections with today's facts; replace issue numbers with label links (good first issue, gap) so the file does not go stale when issues close; move "Done" items older than a quarter into docs/review-ledger.md. Add a small check (a gh call in the monthly re-verify workflow is enough) that every #N in ROADMAP is still open.

Done when

No sentence in ROADMAP contradicts stacks/, site/README.md or the issue tracker; the broken sentence is whole.

Vorherrschende Sprache
JavaScript
Sterne
58
Forks
15
Ø Merge
16 Std. 53 Min.
Gemergte PRs (30 T.)
14

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 TMHSDigital/Free-Game-Dev-Assets

Alle Issues in TMHSDigital/Free-Game-Dev-Assets

Ähnliche Issues

Weitere Issues zu JavaScript

Neue Issues direkt in Ihr Postfach

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