From bab8bacf33937d4051f8422420b66a6e3327b44a Mon Sep 17 00:00:00 2001 From: Zsolt Tasnadi Date: Sun, 16 Aug 2026 16:06:04 +0200 Subject: [PATCH] Follow the workspace and wiki reshuffle The workspace folders now match the Gitea orgs one-to-one, so the note that they deliberately differ no longer holds. wiki-pages sits under infra/, and the wiki gained an engines/ section for our own engines and libraries. Also records that moving a wiki page means adding a redirect in config/site.yaml, which is how the engine pages kept their old URLs working. Co-Authored-By: Claude Opus 5 (1M context) --- plugins/ttg-ops/skills/ttg-new-repo/SKILL.md | 4 ++-- plugins/ttg-ops/skills/ttg-update-docs/SKILL.md | 3 ++- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/plugins/ttg-ops/skills/ttg-new-repo/SKILL.md b/plugins/ttg-ops/skills/ttg-new-repo/SKILL.md index dcb3b97..0bca09c 100644 --- a/plugins/ttg-ops/skills/ttg-new-repo/SKILL.md +++ b/plugins/ttg-ops/skills/ttg-new-repo/SKILL.md @@ -35,13 +35,13 @@ A `private` a tartalom érzékenységéről szóljon, ne az orgról. ## 3. Nyilvántartásba vétel -- **`devarea/scripts/repos.list`** — új sor `|ssh://git@git.teletypegames.org:2222//` alakban, ábécérendben a blokkján belül. A workspace-mappa és az org **szándékosan nem azonos**: a mappák aszerint csoportosítanak, hogyan dolgozol rajtuk, az orgok aszerint, mi a repo. +- **`devarea/scripts/repos.list`** — új sor `/|ssh://git@git.teletypegames.org:2222//` alakban, az org blokkjába, ábécérendben. A workspace-mappa 2026-08-16 óta **egy az egyben az org**, tehát az útvonal az orgból következik. Egyetlen kivétel a `devarea`, ami a gyökérben marad, mert a `clone-repos.sh` a szülőkönyvtárába klónoz. - **`devarea/scripts/check-repos.sh`** — futtasd. Ha zöld, a lista fedi a szervert. Ez a lépés fogja el a „elkészült, de sehol nincs nyilvántartva" hibát. - **`devarea/WIKI_CONNECTION.md`** — ha lesz wiki-oldala, új sor a táblázatba (`Folder`, `Org`, `Title`, `Wiki file`, `URL`). Ha nem lesz, vedd fel a „Folders without a wiki page" felsorolásba. ## 4. Wiki-oldal -Ha a repo dokumentálást érdemel, hozz létre `wiki-pages/pages///default.md`-t. Szekció-választás a rendeltetés szerint: `development/` platformok, `infrastructure/` kiszolgáló, `others/` eszközök, `projects/` termékek. +Ha a repo dokumentálást érdemel, hozz létre `infra/wiki-pages/pages///default.md`-t. Szekció-választás a rendeltetés szerint: `development/` platformok, `engines/` saját motorok és könyvtárak, `infrastructure/` kiszolgáló, `others/` eszközök, `projects/` termékek. A frontmatter kötelező mezői: `title`, `visible`, `id`, `description`, `date`, `locale`, `repo`, `taxonomy.tag`. **Az `id` legyen egyedi** — ellenőrizd (`grep -rh "^id:" pages/ | sort | uniq -d`), a legnagyobb használt fölött adj újat. A `config/sitenav.yaml`-ba is kerüljön bejegyzés, ha a menüben a helye. diff --git a/plugins/ttg-ops/skills/ttg-update-docs/SKILL.md b/plugins/ttg-ops/skills/ttg-update-docs/SKILL.md index 2a1a759..edd63f4 100644 --- a/plugins/ttg-ops/skills/ttg-update-docs/SKILL.md +++ b/plugins/ttg-ops/skills/ttg-update-docs/SKILL.md @@ -33,7 +33,7 @@ Ha a változás egy **mintát** érint, ami több repóban ismétlődik (pl. egy ## 3. Wiki — a `wiki-pages` repo -A wiki **Grav CMS**, a tartalom `wiki-pages/pages/<útvonal>/default.md`. Az oldal nem CMS-ben, hanem fájlban él, tehát szerkeszthető. +A wiki **Grav CMS**, a tartalom `infra/wiki-pages/pages/<útvonal>/default.md` (a repo neve `wiki-pages`, a workspace-ben az `infra/` alatt). Az oldal nem CMS-ben, hanem fájlban él, tehát szerkeszthető. **Melyik oldal tartozik a repóhoz:** a `devarea/WIKI_CONNECTION.md` táblázata mondja meg (`Folder` → `Wiki file`). Ha nincs benne, vagy `grep -rl "" wiki-pages/pages/`. @@ -42,6 +42,7 @@ Amire figyelj: - **Frontmatter.** A `repo:` mező URL-je is elavulhat. Az `id` egyedi legyen (`grep -rh "^id:" pages/ | sort | uniq -d`). - **Mindkét irány.** Ha egy oldal átnevezésre vagy kettévágásra kerül, a `config/sitenav.yaml` bejegyzését is vezesd át, és a **másik két célpontban** lévő wiki-linkeket is (a publikus oldal `CONFIG.wikiBase`-re épülő URL-jét is beleértve). - **Nem csak `pages/`.** A `wiki-pages` repóban van `README.md`, `bbs/` (Gemfile is!), `fetcher/` — ezekben is lehet érintett hivatkozás. +- **Oldal áthelyezésekor** vedd fel a `config/site.yaml` `redirects:` térképébe a régi útvonalat, hogy a kimenő linkek és a könyvjelzők ne törjenek el. - **Commit-konvenció.** A `wiki-pages` repónak saját `git-commit` skillje van, és a konvenciója szerint **nem kerül trailer az üzenetbe** (se `Co-Authored-By`, se generált aláírás). Kövesd. ## 4. Publikus oldal — a `teletypegames` repo