Skip to content

Commit 33233de

Browse files
TMHSDigitalclaude
andcommitted
Guides: drop research and session language, move design history aside
- Remove "from research", "Round 3", "brief" and "this session" wording from the public guides; ai-assets gets a last-reviewed date - provenance.md no longer quotes stale per-publisher counts, and states what publisher does today (named on entry pages, checked for consistency, not grouped); CONTRIBUTING says the same - Delete docs/research-index.md and the CONTRIBUTING section about the gitignored RESEARCH/ folder - Move docs/design/ and docs/superpowers/ under docs/internal/ with a README saying they are design history - Take the review rubric out of the homepage Guides list - godot-budget-stack: Gaea is non-commercial per its EULA, not needs-review Closes #146 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
1 parent 5802c37 commit 33233de

16 files changed

Lines changed: 18 additions & 35 deletions

‎CONTRIBUTING.md‎

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@ To add a starter stack (one pick per need for a kind of game), follow [`stacks/R
5050
- `commercial`: `true` / `false` / `unknown` / `varies`. Use `varies` for aggregators where some files are commercial-ok and others are not. The site still shows these under Commercial OK, labeled **per-file review**, so they are not silently excluded and not silently treated as a blanket grant.
5151
- `attribution_required`: `true` / `false` / `unknown`. If the licence normally requires credit (CC-BY) but the publisher waives it, set `false` and add a `- Attribution waived:` line in Notes saying so.
5252
- `attribution_string`: the copy-paste credit line. Required when `attribution_required` is `true`; optional otherwise.
53-
- `publisher`: optional. Name the **rights-holding publisher**, never the host. Set it whenever that publisher has more than one catalog entry, so the entries group; setting it on a publisher that currently has only one entry is also fine and saves a backfill later. Do not set it to a generic host or distributor (GitHub, Hugging Face, itch.io, OpenGameArt, the Internet Archive, Google Fonts) or to a distributor that does not hold the rights. Distinguish sibling organisations that are genuinely different rights holders: `blender.md` (the application, Blender Foundation) carries no `publisher`, while the asset bundles under `studio.blender.org` carry `Blender Studio`. Kenney, Quaternius, KayKit, LuizMelo, 0x72, Blender Studio, Material Maker, Alif Type, GGBotNet and 3dmodelscc0 are the largest groups in use today; treat that as illustrative, not as the permitted set.
53+
- `publisher`: optional. Name the **rights-holding publisher**, never the host. Set it whenever that publisher has more than one catalog entry, so each entry page names the same publisher and the validator can check that the group agrees; setting it on a publisher that currently has only one entry is also fine and saves a backfill later. Do not set it to a generic host or distributor (GitHub, Hugging Face, itch.io, OpenGameArt, the Internet Archive, Google Fonts) or to a distributor that does not hold the rights. Distinguish sibling organisations that are genuinely different rights holders: `blender.md` (the application, Blender Foundation) carries no `publisher`, while the asset bundles under `studio.blender.org` carry `Blender Studio`. Kenney, Quaternius, KayKit, LuizMelo, 0x72, Blender Studio, Material Maker, Alif Type, GGBotNet and 3dmodelscc0 are the largest groups in use today; treat that as illustrative, not as the permitted set.
5454
- `subcategories`: lower-case kebab-case (`base-meshes`, `field-recordings`). Reuse a value already in the catalog before inventing one, and do not add a variant of an existing value that differs only in plural or spelling. Where both forms were in use, the more common one was kept (`characters`, `environment`, `interior`, `tileset`, `vectors`, `pixel`, `impulse-responses`, `base-meshes`). Retired spellings are listed in [`site/value-aliases.json`](site/value-aliases.json), which the validator enforces (V19); add a line there when you merge two values.
5555
- `formats`: what you actually get, in one of four kinds. **File formats**, as commonly written: usually upper case (`PNG`, `FBX`, `JSON`, `VOX`), tool-specific ones as the tool writes them (`gdshader`, `tmx`, `ktx2`). **Engine or language targets**, as the product writes them (`glTF`, `Godot`, `Unity`, `Python`, `React`). **Delivery types** for software with no file format of its own, lower-case kebab-case (`godot-addon`, `blender-extension`, `npm`, `cli`, `library`, `desktop-app`, `mobile-app`, `middleware`, `model`). And `various` for an aggregator whose files come in too many formats to list. Platforms (`windows`, `macos`, `ios`) and descriptions (`heightfield`, `examples`) are `tags`, not formats. The allowed values are the closed list in [`site/format-vocabulary.json`](site/format-vocabulary.json), which the validator enforces (V20): reuse a listed spelling, and add a genuinely new format there in the same change that first uses it. Its `groups` drive the site's Format filter, so a new format that belongs to a group (another glTF or font container) goes into that group too. A format outside every group is still searchable and shown on the card, but the Format filter cannot select it.
5656
- `tags`: lower-case kebab-case words describing the content (`low-poly`, `modular`, `platformer`). Do not restate another field: the licence (`cc0`, `mit`, `ofl`, `open-source`, `royalty-free`), the credit requirement (`no-attribution`) or the entry's own `publisher` (`kenney`) are rejected (V19 via `site/value-aliases.json`, V21), because search and the filters read those fields directly and a copied tag drifts. A `varies` entry lists its licence mix in the body, not in tags.
@@ -108,7 +108,3 @@ Changes drafted with an agent or a script are judged on the diff like any other.
108108
## Licence of contributions
109109

110110
By opening a pull request you dedicate your contribution to the public domain under [CC0 1.0](LICENSE), like the rest of the repository's metadata and documentation. Quotes from licence pages stay the publisher's words; they are used as short factual quotations, and the assets they describe keep their own licences.
111-
112-
## Research notes
113-
114-
Local Gemini / deep-research drafts live under `RESEARCH/` as `R0N-<topic>.md` (gitignored; see [`docs/research-index.md`](docs/research-index.md)). Promote durable findings into catalog entries and `docs/` — don’t rely on drafts as the public source of truth.

‎README.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -380,8 +380,8 @@ npm run serve # preview at http://localhost:3000
380380
│ ├── licenses.md fonts.md geodata.md game-vs-video-licensing.md
381381
│ ├── provenance.md high-risk.md ai-assets.md fivem.md trust-score.md
382382
│ ├── godot-budget-stack.md unreal.md
383-
│ ├── research-index.md maintainer notes on local research drafts
384-
│ ├── design/ design specs behind the entry pages, stacks and freshness page
383+
│ ├── data.md the JSON, CSV and feed exports
384+
│ ├── internal/ design specs and plans behind the site (history, not guides)
385385
│ ├── review-ledger.md every review pass and what it changed
386386
│ └── images/readme/ publisher stills used in this README
387387
├── stacks/ starter stacks: one pick per need for a kind of game

‎docs/ai-assets.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
# AI-generated assets — catalog policy
22

3-
Synthesized from gap research (as of early 2026 claims in that brief — **re-verify** before relying on dates/rulings).
3+
Last reviewed 2026-10-23. Court rulings and platform rules on AI content change quickly: **re-verify** dates and rulings before relying on them.
44

55
## Practical catalog rules
66

77
1. **Prefer human-authored CC0 / clear commercial licenses** for default recommendations.
8-
2. **Label AI tooling** clearly (`tags: [ai-generated]` or `compliance:ai-disclosure`) when an entry is primarily generative.
8+
2. **Label AI tooling** clearly (`tags: [ai-generated]`) when an entry is primarily generative.
99
3. **Do not treat “public domain because AI” as a shipping strategy** — platform rules (Steam disclosure), training-data risk, and publicity/voice rights still apply.
1010
4. **Exclude free-tier cloud TTS/voice** that is non-commercial (ElevenLabs-class) from “commercial OK” lists.
1111
5. **Prefer local permissive models** (Apache 2.0 / MIT) when synthetic VO is needed.

‎docs/godot-budget-stack.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# Godot-oriented free stack (from research)
1+
# Godot-oriented free stack
22

3-
Synthesized from local research on Godot 4 physics / destruction pipelines. Focus: **free or CC0 assets + free Godot tooling**. Not a full game production plan.
3+
A starting point for Godot 4 physics and destruction pipelines. Focus: **free or CC0 assets + free Godot tooling**. Not a full game production plan.
44

55
## Assets (free / CC0 first)
66

@@ -31,7 +31,7 @@ Paid Sonniss impact packs can fill metal/glass destruction gaps on a small budge
3131
| Steamworks bindings | [GodotSteam](../catalog/tools/godotsteam.md) (add-on MIT; Steamworks itself needs Valve's partner agreement) |
3232
| Mod loading | [Godot Mod Loader](../catalog/tools/godot-mod-loader.md) (MIT) |
3333
| 2D textured polygons / terrain | [SmartShape2D](../catalog/tools/smartshape2d.md) (MIT) |
34-
| Heightmap terrain | [Terrain3D](../catalog/tools/terrain3d.md) (MIT). [Gaea Community Edition](../catalog/tools/gaea.md) is `needs-review`; EULA is a PDF this session, not a free commercial grant |
34+
| Heightmap terrain | [Terrain3D](../catalog/tools/terrain3d.md) (MIT). [Gaea Community Edition](../catalog/tools/gaea.md) is free for non-commercial use only (EULA section 1.4.1); a commercial game needs a paid edition |
3535
| Behavior trees | [Beehave](../catalog/tools/beehave.md) (MIT) |
3636
| Utility AI | [LimboAI](../catalog/tools/limboai.md) (MIT) |
3737

‎docs/high-risk.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ Sources that fail our commercial-safety bar. Keep out of `status: active` listin
1313
| **SFU Motion Capture Database** | Explicitly free for research only — “cannot be used for commercial products or resale.” |
1414
| **AMASS** | Live `license.html` (2026-08-25): “non-commercial scientific research” and “use for commercial purposes, is prohibited.” Meshes are SMPL, so the SMPL commercial lock also applies. |
1515
| **Human3.6M** | Live EULA (2026-08-25): “GRANT OF LICENSE FREE OF CHARGE FOR ACADEMIC USE ONLY.” Free tier is academic; commercial licensing is a separate paid path. |
16-
| **Ready Player Me** | Homepage and `/legal` connection refused (2026-08-25). GitHub `animation-library` LICENSE.md: animations “licensed for use with Ready Player Me Avatars”; use with other characters “is prohibited.” Avatar mesh terms were not readable this session. Do not catalog until the live site terms load. |
16+
| **Ready Player Me** | Homepage and `/legal` connection refused (2026-08-25). GitHub `animation-library` LICENSE.md: animations “licensed for use with Ready Player Me Avatars”; use with other characters “is prohibited.” Avatar mesh terms were not readable on 2026-08-25. Do not catalog until the live site terms load. |
1717
| **ElevenLabs / similar free TTS tiers** | Free tiers often **non-commercial**; commercial rights sit behind paid plans. Prefer local Apache/MIT TTS (Kokoro, Piper Plus). |
1818
| **Google Maps / Earth meshes** | Scraping via RenderDoc/plugins violates ToS — not public domain. |
1919
| **ColorADD symbols** | Proprietary accessibility coding system; needs a paid license. |

‎docs/internal/README.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# Design history
2+
3+
Specs and implementation plans written while building the site: the entry pages, starter stacks, the freshness page and the 2026-10 site refresh. They record why the site works the way it does. They are not user guides and may describe plans that changed; the guides one level up and [the site README](../../site/README.md) describe what is true now.
File renamed without changes.
File renamed without changes.

docs/design/2026-09-25-licence-freshness-design.md renamed to docs/internal/design/2026-09-25-licence-freshness-design.md

File renamed without changes.

docs/superpowers/plans/2026-10-23-site-refresh.md renamed to docs/internal/superpowers/plans/2026-10-23-site-refresh.md

File renamed without changes.

0 commit comments

Comments
 (0)