janus/janus-docs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
54 commits 1 branch 0 tags 826 KiB
  • CSS 49.5%
  • MDX 40.7%
  • JavaScript 7.4%
  • Astro 1.8%
  • TypeScript 0.6%
Find a file
Exact
Markus Maiwald 79db52d7ae
All checks were successful
Deploy docs.janus-lang.org / Build & Deploy (push) Successful in 1m38s
Details
docs(cluster): document capability-gated actor refs
2026-05-16 11:52:15 +02:00
.forgejo/workflows ci: fix runner label to node-20 for Forgejo Actions 2026-03-16 12:16:50 +01:00
public feat: initial janus-docs Starlight site 2026-03-08 12:09:03 +01:00
src docs(cluster): document capability-gated actor refs 2026-05-16 11:52:15 +02:00
.gitignore chore(deps): bump Astro 5 -> 6, Starlight 0.37 -> 0.38; gitignore agent dirs 2026-05-03 02:02:40 +02:00
astro.config.mjs docs(cluster): Phase B - actor state release + stateful actors tutorial 2026-05-15 09:45:13 +02:00
package-lock.json chore(deps): bump Astro 5 -> 6, Starlight 0.37 -> 0.38; gitignore agent dirs 2026-05-03 02:02:40 +02:00
package.json chore(deps): bump Astro 5 -> 6, Starlight 0.37 -> 0.38; gitignore agent dirs 2026-05-03 02:02:40 +02:00
README.md docs: replace template README with project README 2026-03-08 12:39:24 +01:00
tsconfig.json feat: initial janus-docs Starlight site 2026-03-08 12:09:03 +01:00
wrangler.toml feat: initial janus-docs Starlight site 2026-03-08 12:09:03 +01:00

README.md

docs.janus-lang.org

Official documentation for the Janus programming language.

Live: docs.janus-lang.org

Structure

src/content/docs/
├── learn/           8 pages — introduction, quick start, profiles, fundamentals
├── tutorials/       4 pages — hello-to-production, CLI tool, errors, Zig interop
├── reference/       4 pages — error doctrine, UFCS, grafting, filesystem
├── architecture/    3 pages — ASTDB, lexer, diagnostics
├── philosophy/      5 pages — manifesto, bedrock, pragmatism, vision, symbology
└── index.mdx        Landing page

Development

npm install
npm run dev          # Local dev server at localhost:4321
npm run build        # Production build to ./dist/

Deployment

Hosted on Cloudflare Pages. Deploy with:

npx wrangler pages deploy dist --project-name=janus-docs

Stack

  • Starlight (Astro) — documentation framework
  • Pagefind — client-side search (built-in)
  • Expressive Code — syntax highlighting (Janus aliased to Zig)
  • Cloudflare Pages — hosting + CDN

License

Content: Libertaria Unbound License (LUL-1.0)