Skip to content

ADR 0044

github-actions[bot] edited this page Nov 21, 2026 · 1 revision

Status: accepted · Built: done · Date: 2026-11-22 · Supersedes: 0014, 0024

Adopts the ecosystem's ADR 0003 for this repository. Built: apps/site, pages.yml and the astro-site skill removed; the landing page and the showcase are kodentuzo.com/spotcraft (kodentuzo/website 0.1.0); docs/README.md is the wiki's Home, docs/development.md holds the setup; a wiki job on main; the README is for readers. spotcraft.dev redirects to kodentuzo.com/spotcraft in Cloudflare (outside this repository). The image stays vindotski/spotcraft for now.

Spotcraft's web pages are a section of kodentuzo.com, and docs/ is the wiki

Context

Spotcraft's website, spotcraft.dev, was an Astro site in apps/site (ADR 0014, ADR 0024). It rendered this repository's Markdown as docs and held a showcase of apps. The ecosystem's ADR 0003 makes kodentuzo.com the only website and each repository's docs/ its GitHub wiki.

Decision

  • No website in this repository. Spotcraft's landing page and showcase are the /spotcraft section of kodentuzo.com, in kodentuzo/website. spotcraft.dev and its pages redirect there; its docs pages redirect to a page that links the wiki.
  • docs/ is the wiki, published on every push to main by the ecosystem's wiki action. docs/README.md is its Home. Package READMEs stay next to their code, and the wiki links them.
  • The README is for readers: what Spotcraft is and how it's built, with no setup steps; those are in docs/getting-started.md and docs/development.md.

Consequences

  • The workspace has no Astro, and pnpm verify no longer builds a site.
  • Docs are read on GitHub. A page's address is its file name: renaming a file in docs/ changes its wiki page.
  • The showcase is edited in kodentuzo/website, and changes with a site release.

Clone this wiki locally