Skip to content

✨ feat: add project catalog for lab and docs - #79

Draft
zrr1999 wants to merge 1 commit into
mainfrom
cursor/platform-architecture-0604
Draft

zrr1999 wants to merge 1 commit into
mainfrom
cursor/platform-architecture-0604

Conversation

@zrr1999

@zrr1999 zrr1999 commented Sep 30, 2026

Copy link
Copy Markdown
Owner

动机

把 Lab、中央文档和产品官网的边界定成仓库约定。小项目从 Lab 进入,公开文档从 docs.zrr.dev 发布;产品官网在项目侧独立演进,购买专有域名时只改入口。

解决方案

  • 在 docs/platform.md 写下三阶段。小项目使用 lab.zrr.dev/<project>/ 和 docs.zrr.dev/<project>/。产品化后官网迁到项目侧,<project>.zrr.dev/docs 跳到中央文档并保留章节路径。专有域名阶段,旧子域名整站跳到新入口,官网可以留在代码仓库,也可以放在所属组织下的单独网站仓库。
  • 增加 packages/project-catalog。每个项目一份 TOML,推导 Lab、文档和官网地址,并生成 zrr.dev 域名上的 308 跳转。
  • 按当前事实登记 Cue、Spark、Zendev、Rill 和 Spore。lab.zrr.dev 与 docs.zrr.dev 尚未部署,跳转规则也还没有发到 Cloudflare。

说明

文档权威地址在三个阶段都是 docs.zrr.dev/<project>/。产品站和专有域名上的 /docs 是入口,不是第二套文档站。

Rill 的文档站目前占用 rill.zrr.dev。docs.zrr.dev/rill/ 提供相同页面前,不要部署这条旧主机跳转。Spore 官网已经在 spore-lang/spore-lang.dev,文档仍由 docs.spore-lang.dev 发布,接入中央文档前不登记构建方式。

首页项目列表仍在 apps/root。Lab 接管目录之前,调整已登记项目的对外摘要时,登记表和首页一起改。

后续工作

  • 增加 apps/lab 与 apps/docs。先接入 Zendev,走通获取源码、子路径构建、编辑链接和旧主机跳转,再接入 Rill。
  • 公开文档逐个切到 docs.zrr.dev/<project>/ 后,再关闭原来的文档发布并保留旧地址跳转。
Open in Web Open in Cursor 

Record the platform boundary: lab introductions and central docs stay in this repo, a product site moves once to the project side, and a custom domain only changes the entry.

The catalog derives public URLs and zrr.dev redirects from one TOML file per project.
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Sep 30, 2026 •

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
zrr-website-blog 953557c Commit Preview URL

Branch Preview URL
Sep 30 2026, 06:26 AM

@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
zrr-website-slides 953557c Commit Preview URL

Branch Preview URL
Sep 30 2026, 06:24 AM

@gitar-bot

gitar-bot Bot commented Sep 30, 2026

Copy link
Copy Markdown
Code Review ✅ Approved

🟡 Medium risk · Adds project catalog validation and generated 308 host/path redirect rules.

Adds a project catalog system in packages/project-catalog to manage Lab, documentation, and product website boundaries across development stages, with TOML-based project registration for Cue, Spark, Zendev, Rill, and Spore. No issues found.

Review coverage

📋 Rules No rules evaluated

🧪 Functional validation Not enabled · Set up

Options

Auto-apply is off → Gitar will not commit updates to this branch.
Display: compact → Counting what did not apply, without listing it.

Comment with these commands to change the behavior for this request:

Auto-apply Compact
gitar auto-apply:on         
gitar display:verbose         

Was this helpful? React with 👍 / 👎 | Gitar

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Sep 30, 2026 •

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
zrr-website-root 953557c Commit Preview URL

Branch Preview URL
Sep 30 2026, 06:27 AM

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants