docs(plan): revision 4 — a second game, RunicNPC, and a vocabulary rule #32

wtclaude · 2026-10-22T07:17:31-05:00

wtclaude commented

2026-10-22 07:17:31 -05:00

What & why

This is the planning PR for bringing the site up to date with the Rust module and RunicNPC, and for moving game-specific vocabulary (shard, guild, clan, wipe, ServUO, Oxide…) out of the site at large and into each game's own section. It changes PLAN.md only. No site code changes.

It adds §16 with the six decisions taken on 2026-10-22, D60–D65 (count of record: sixty-five):

D60: per-game sidebar groups. Getting started and the core groups become game-neutral. New Ultima Online and Rust groups hold the game material, and every moved page gets a redirect.
D61: RunicNPC is a subgroup inside Rust, plus a standalone /runicnpc/ page for Rust server owners who don't run the platform.
D62: the RunicNPC API is carried in full on the site, with a drift check against docs/runicnpc/API.md. This is a deliberate exception to §1's "link, never copy" rule.
D63: outside the game sections, game names are allowed but game vocabulary is not. A "Supported games" strip links out to each game.
D64: checkTerms.mjs, a twelfth check that enforces D63. It amends D53.
D65: Rust screenshots are taken last, from the rigs, and there are no placeholders before then.

It also adds phases 13–18, one PR each, with a pause between them. Phase 13 (facts) comes first.

For review: one proposed rule

§16 "One rule the phases need" proposes that a screenshot belongs to its game. The alt text and caption of a capture tagged with a game may use that game's words, as long as the page names the game beside it. Phase 9's UO captures say "Shard" in their pixels. Object here if that's wrong.

Known red

checkFacts is already red on main: platform.json says Module API 1.10.0 and installer v0.2.0, but the platform is at 1.17.0 and v0.8.0. This PR doesn't fix that. Phase 13 does.

How it was tested

Docs-only change. I ran checkFacts against main (with a token) to confirm the two drifts quoted above. I verified Rust facts from installer bundles:v2/rust/current.json, Module-Rust main:module.json and the releases API.

Checklist

I have read CONTRIBUTING.md.
npm run verify passes locally. Not run: this changes PLAN.md only, and check:facts is red on main regardless (see above).
No fact is stated in prose. Versions are quoted in PLAN.md as the record of what was read, not on a page.
PLAN.md still describes what this repository does. D53 is amended by D64, with the reasoning.
My commits are reasonably scoped, with Conventional Commit messages.

AI-assisted contributions (required)

No AI tools were used to produce this contribution.
AI tools were used. Tool(s): Claude Code (Claude Opus 5.5). AI-authored commits are marked with a Co-Authored-By trailer.

License

I agree that my contribution is licensed under this project's license (GNU GPL v3.0 or later).

🤖 Generated with Claude Code

https://claude.ai/code/session_01E14m6SuuY6i1vASFeGDBeY

## What & why This is the planning PR for bringing the site up to date with the Rust module and RunicNPC, and for moving game-specific vocabulary (shard, guild, clan, wipe, ServUO, Oxide…) out of the site at large and into each game's own section. It changes `PLAN.md` only. No site code changes. It adds **§16** with the six decisions taken on 2026-10-22, **D60–D65** (count of record: sixty-five): - **D60**: per-game sidebar groups. *Getting started* and the core groups become game-neutral. New **Ultima Online** and **Rust** groups hold the game material, and every moved page gets a redirect. - **D61**: RunicNPC is a subgroup inside Rust, plus a standalone `/runicnpc/` page for Rust server owners who don't run the platform. - **D62**: the RunicNPC API is carried in full on the site, with a drift check against `docs/runicnpc/API.md`. This is a deliberate exception to §1's "link, never copy" rule. - **D63**: outside the game sections, game *names* are allowed but game *vocabulary* is not. A "Supported games" strip links out to each game. - **D64**: `checkTerms.mjs`, a twelfth check that enforces D63. It amends D53. - **D65**: Rust screenshots are taken last, from the rigs, and there are no placeholders before then. It also adds phases **13–18**, one PR each, with a pause between them. Phase 13 (facts) comes first. ### For review: one proposed rule §16 "One rule the phases need" proposes that **a screenshot belongs to its game**. The alt text and caption of a capture tagged with a game may use that game's words, as long as the page names the game beside it. Phase 9's UO captures say "Shard" in their pixels. Object here if that's wrong. ### Known red `checkFacts` is **already red on `main`**: `platform.json` says Module API 1.10.0 and installer v0.2.0, but the platform is at 1.17.0 and v0.8.0. This PR doesn't fix that. Phase 13 does. ## How it was tested Docs-only change. I ran `checkFacts` against `main` (with a token) to confirm the two drifts quoted above. I verified Rust facts from `installer` `bundles:v2/rust/current.json`, `Module-Rust` `main:module.json` and the releases API. ## Checklist - [ ] I have read [CONTRIBUTING.md](CONTRIBUTING.md). - [ ] `npm run verify` passes locally. Not run: this changes PLAN.md only, and `check:facts` is red on `main` regardless (see above). - [x] No fact is stated in prose. Versions are quoted in PLAN.md as the record of what was read, not on a page. - [x] `PLAN.md` still describes what this repository does. D53 is amended by D64, with the reasoning. - [x] My commits are reasonably scoped, with Conventional Commit messages. ## AI-assisted contributions (required) - [ ] No AI tools were used to produce this contribution. - [x] AI tools were used. Tool(s): `Claude Code (Claude Opus 5.5)`. AI-authored commits are marked with a `Co-Authored-By` trailer. ## License - [x] I agree that my contribution is licensed under this project's license (**GNU GPL v3.0 or later**). 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01E14m6SuuY6i1vASFeGDBeY

wtclaude added 1 commit 2026-10-22 07:17:33 -05:00

docs(plan): revision 4 - a second game, RunicNPC, and a vocabulary rule

PR checks / checks (pull_request) Failing after 1m52s

Details

b1584043a3

Adds PLAN.md section 16 with the org lead's six decisions of 2026-10-22
(D60-D65) and phases 13-18:

- D60 per-game sidebar groups (Ultima Online, Rust); core docs go
  game-neutral, moved pages keep redirects
- D61 RunicNPC as a subgroup inside Rust, plus a standalone /runicnpc/
- D62 the RunicNPC API carried in full, with a drift check against
  docs/runicnpc/API.md (a deliberate exception to section 1)
- D63 game names allowed outside game sections, game vocabulary not
- D64 checkTerms.mjs, a twelfth check, amending D53
- D65 Rust screenshots last, captured from the rigs

Also records what moved since the site's last fact check: Module API
1.17.0 and installer v0.8.0 (main is already red on both), Module-Rust
v0.5.0, the v2/rust bundle at protocol 14, and RunicNPC v1.0.0.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01E14m6SuuY6i1vASFeGDBeY

whitlocktech merged commit 2971b84d51 into main

2026-10-22 07:59:56 -05:00

whitlocktech deleted branch docs/second-game-plan

2026-10-22 07:59:57 -05:00

whitlocktech referenced this issue from a commit

2026-10-22 07:59:58 -05:00

Merge pull request 'docs(plan): revision 4 — a second game, RunicNPC, and a vocabulary rule' (#32) from docs/second-game-plan into main

wtclaude referenced this pull request

2026-10-22 08:09:48 -05:00

feat(facts): phase 13 — per-game facts, Rust and RunicNPC checked, main green again #33

wtclaude referenced this issue from a commit

2026-10-22 08:54:48 -05:00