Publish knowledge/ to knowledge.oriz.in via Kiso + CF Pages

decision Fri Jul 03 2026 00:00:00 GMT+0000 (Coordinated Universal Time) okfpublishingcloudflare-pageskisoknowledge

Publish knowledge/ to knowledge.oriz.in

Decision

Mirror knowledge/ OKF bundle to https://knowledge.oriz.in. Cloudflare Pages host. Kiso build engine. GH Action deploy on push to main.

Why

Discoverability — 793 concept files invisible unless public.
Backup — third copy (workspace + 6 mirror hosts + cloud site).
Ecosystem contribution — one of first OKF-in-the-wild public bundles.
Agent reach — external agents can fetch via URL, not just local read.

Build engine — Astro custom (Kiso deferred)

Fresh verification 2026-07-03 found Kiso is HN-post-only (no installable software). Fallback: custom Astro on api-fleet-template pattern. See okf-build-engine-astro-2026-07-03.

Astro Integration ships: OKF Zod schema, llms.txt auto-gen, @astrojs/sitemap, @astrojs/rss, FlexSearch client-side, related.json precompute.

Reject: 11ty (no family precedent), Hugo/Zola (Go/Rust — heavier).

Host — Cloudflare Pages

Per locked cloudflare-pages-only. 500 builds/mo free, unlimited bandwidth, no card. Aligns with no-card-on-file.

Path — knowledge.oriz.in

Per one-level-subdomain-only + subdomain-name-content-type convention. Not docs.oriz.in (mixed content) or brain.oriz.in (breaks naming).

Additions on top

llms.txt + sitemap.xml at root (Kiso default).
RSS/Atom feed on /feed.xml — no OKF convention exists yet; first-mover. Content = new/updated concept files last 30 days.
witscode validator as CI gate — blocks bad frontmatter before deploy.
OKF conformance badge on README.

Sequence

Extend repos/own/infra/api-fleet-template with OKF-content-collection support (Zod schema for v0.2 frontmatter, related.json compute).
New repo chirag127/knowledge-site (or Astro app inside workspace) consumes knowledge/ via symlink or submodule of umbrella.
Wire .github/workflows/publish-knowledge.yml: on push to main, build via Astro, deploy to CF Pages.
CF DNS: knowledge.oriz.in → CF Pages project.
witscode validator step BEFORE build step (adopt as workspace CI gate).
RSS/Atom generator baked into Astro build (@astrojs/rss).

Anti-patterns

❌ Ship auth-walled — violates no-auth-in-apps-or-apis.
❌ Add analytics scripts that block content load — CF Web Analytics only.
❌ Custom domain via CF Registrar (card) — Spaceship registrar per services/domain/spaceship.