Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

catalog: normalise 12 licence values to SPDX ids and fix a few small data defects

Open
  • Is something wrong?
#95 1 comment 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
55/100
Issue type
Bug
Clarity
Clearly specified
Activity status
Active
Tech stack
javascript, json, markdown
Domain
content, tooling

Research direction

Start with site/value-aliases.json and the named catalog entries, then read CONTRIBUTING and inspect each source to confirm the SPDX variant before changing aliases. Check how the catalog validator handles entry URLs and metadata, and add the requested uniqueness, HTTPS, and H1/name checks. Done when the license mappings, links, and listed data defects are corrected and the validator passes.

Written by the indexing model from the issue text.

Description

correction good first issue priority: medium

Why it matters
license_spdx is the field tools and filters key on, and it is empty for 105 of 414 entries. 93 of those are legitimately custom/varies/unknown, but 12 are aliases of ids other entries already use, so the same licence filters differently depending on who wrote the entry. A handful of other mechanical defects showed up in the same audit.

Evidence (data audit 2026-10-21)

  • license values with no SPDX mapping that should have one: GPL-3.0 (7 entries), GPL-2.0 (2), LGPL-3.0 (1), BSD (1), CC-BY (1). Elsewhere the catalog uses GPL-3.0-or-later, GPL-2.0-or-later, BSD-3-Clause, CC-BY-4.0.
  • catalog/audio/filmmusic-ende.md is CC-BY with attribution_required: false; CONTRIBUTING allows that only with an "Attribution waived" Notes line. Confirm one exists or flip the flag.
  • Two http:// entry URLs: catalog/animation/cmu-mocap.md, catalog/characters/makehuman.md; 10 more http:// links in bodies.
  • One URL shared by two entries: blender.org/download/demo-files/#assets in catalog/animation/blender-ellie-poses.md and catalog/characters/blender-human-base-meshes.md. Point each at its own anchor or merge.
  • 24 entries whose # H1 differs from name (for example catalog/3d/kaykit.md: name "KayKit (Kay Lousberg)", H1 "KayKit").
  • 5 entry URLs are search pages with query strings (fab.com/search?is_free=1 and similar), which break when the host changes its search UI.

Suggested approach

  1. Map the 12 aliases to the right SPDX id after checking each source for "or later" vs "only" (do not guess); add the aliases to site/value-aliases.json so the validator rejects them going forward.
  2. Fix the http URLs and the duplicate URL; add a validator rule that an entry url must be unique and https.
  3. Add a check (warning is fine) that H1 equals name.
  4. Replace search-page URLs with a stable listing page where one exists; otherwise note the fragility in Notes.

Done when
license_spdx is set for every entry whose license is a real SPDX licence, the new validator rules pass, and the defects above are gone.

Dominant language
JavaScript
Stars
58
Forks
15
Avg merge
16h 53m
Merged PRs (30d)
14

Getting set up

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.

More from TMHSDigital/Free-Game-Dev-Assets

All issues in TMHSDigital/Free-Game-Dev-Assets

Similar issues

More JavaScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.