You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit f482137
Browse filesBrowse the repository at this point in the historyBrowse files
- feed.xml: feed-level <author> (RFC 4287) (#59)
- llms.mjs reads links with the shared LINK_RE, so balanced-paren hrefs
cannot crash the build after the page gate (#60)
- renderInline strips NUL before using it as a slot marker; validate
rejects C0 control characters (#61)
- catalog.csv neutralises formula-leading cells (#62)
- shortlist button's accessible name starts with its visible text (#63)
- one entry walker (lib/entry-files.mjs) for build, validate, sync-counts
and check-links; kebab-case ids enforced (#64)
- check-links: pure parts in lib/link-check.mjs with tests, multi-part
suffixes, inert report URLs; V16 rejects private hosts (#65)
- client lookups without a prototype; shortlist export slash fix (#66)
- tests for all of the above (#67, partly)
- "not legal advice" in README, licences guide, footers, CREDITS (#68)
- ROADMAP without drifting counts or shipped items (#69)
- contributor path aligned; TEMPLATE starts needs-review (#70)
- README positioning vs magictools / awesome-gamedev, with credit (#71)
- specs to docs/design, research-index out of user guides, trust-score
labelled as a rubric (#73)
- homepage WebSite + Dataset JSON-LD (#74)
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+10-4Lines changed: 10 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,12 +11,18 @@ Please follow the [Code of Conduct](CODE_OF_CONDUCT.md).
11
11
- Free engine add-ons / plugins that materially help asset or production pipelines (e.g. Godot Asset Library tools)
12
12
- Engines only when they ship substantial free asset libraries
13
13
14
+
## Accepted with caveats
15
+
16
+
- A source whose licence is unclear: add it as `status: needs-review` with the open question in
17
+
Notes, or open an issue instead.
18
+
- A source that is free only for non-commercial or personal use: only if it is clearly marked
19
+
`commercial: false`.
20
+
14
21
## What does not
15
22
16
23
- Paid-only marketplaces with no free content worth listing
17
-
- Broken, abandoned, or license-unclear sources (use `status: needs-review` or open an issue)
24
+
- Brokenor abandoned sources
18
25
- Redistributed ZIP/GLB/WAV files of third-party work
19
-
- Assets that are free only for non-commercial / personal use (unless clearly tagged `commercial: false`)
20
26
- GTA V / RDR2 extracts, FiveM MLO leaks, Tebex reuploads, and anonymous `fivem-props` dumps (see [`docs/fivem.md`](docs/fivem.md) and [`docs/high-risk.md`](docs/high-risk.md))
21
27
22
28
## Adding an entry
@@ -26,10 +32,10 @@ are no dependencies to install.
26
32
27
33
1. Run `node site/new-entry.mjs <category> <id>` (or `npm run new-entry -- <category> <id>`). It copies [`catalog/TEMPLATE.md`](catalog/TEMPLATE.md) to `catalog/<category>/<id>.md` with the id, category and today's date filled in, and refuses an id already used anywhere in the catalog. Use a short kebab-case `id`; a mixed kit already listed in another category is a duplicate, not a second entry.
28
34
2. Verify the license on the live source page the day you submit, and fill every frontmatter field from it (rules below). Prefer primary URLs over mirror/aggregator pages.
29
-
3. Write the body: a one-paragraph summary, `## Notes`, and `## Evidence` with a dated line quoting the source, such as `- Live page (2026-09-25): "Free for commercial use"`. Every Evidence section needs at least one date, and `verified` may not be newer than the newest one. The scaffold starts at `status: needs-review`; set `active` once the licence, the commercial stance and the credit requirement are all settled.
35
+
3. Write the body: a one-paragraph summary, `## Notes`, `## Evidence` with a dated line quoting the source, such as `- Live page (2026-09-25): "Free for commercial use"`, and optionally `## Related` linking sibling entries. Every Evidence section needs at least one date, and `verified` may not be newer than the newest one. The template (and so the scaffold) starts at `status: needs-review`; set `active` once the licence, the commercial stance and the credit requirement are all settled.
30
36
4. Add a row to the matching category `README.md`. This is required: the validator fails an entry that is not listed there, and the row's licence cell must match your frontmatter.
31
37
5. Run `node site/sync-counts.mjs` (`npm run counts`). It updates every place the repo restates the entry count: both category count tables, the README badge and "Browse N sources" line, and `expectedEntryCount` in [`site/config.json`](site/config.json).
32
-
6. Run `npm run check`: the checktests, `node site/validate.mjs` and `node site/build.mjs`, all of which must pass. The build renders your entry's page and fails if the body uses markdown the site does not support (tables, code fences, blockquotes, images, raw HTML, `###` headings, numbered lists) or links to a file that does not exist.
38
+
6. Run `npm test && npm run validate` before you push; that is quick. CI then runs `npm run check` (the tests, `node site/validate.mjs` and `node site/build.mjs`), and all of it must pass. Run `npm run check` yourself if you changed the site or want to preview your entry's page. The build renders your entry's page and fails if the body uses markdown the site does not support (tables, code fences, blockquotes, images, raw HTML, `###` headings, numbered lists) or links to a file that does not exist.
33
39
7. Optional: add the `id` to `site/config.json` → `featured` to pin it under Safe starting points.
34
40
35
41
To add a starter stack (one pick per need for a kind of game), follow [`stacks/README.md`](stacks/README.md).
0 commit comments