apache / apache/maka

infra: publish the podling website at maka.apache.org

Open
#3,404 6 comments 0 reactions 1 assignee Claimed by @Astro-Han View on GitHub
documentation
Dominant language
TypeScript
Stars
5.4k
Forks
502
Avg merge
1d 2h
Merged PRs (30d)
715

Description

English

Part of #2974, supports #3272 (G5: Incubator branding and release surfaces).

**`maka.apache.org` serves the podling website.** This issue owns the publication path and the pages ASF policy requires; what the site says was settled in #4307.

## Delivered

- The site source is in `apache/maka` under `website/`, following OpenDAL rather than a separate site repository. A workflow builds it and force-pushes to `asf-site`, `.asf.yaml` publishes that branch, and `staging: autostage: site/*` gives release candidates a review path (#4660, live since 2026-09-03).
- Every page identifies Apache Maka (Incubating), carries the full Incubator disclaimer and the ASF footer, and loads nothing from a third party. Fonts and assets carry recorded provenance, and the site carries `LICENSE` and `NOTICE`.
- The downloads page states that the signed source archive is the release, keeps Desktop Nightly, source builds and future Apache Releases separate, and gives the `KEYS`, GPG and SHA-512 steps a reviewer runs before voting.
- The homepage is complete in English and Chinese with the same sections, claims, warnings and links. @Astro-Han keeps the two in sync. A benchmarks block links the reports in [`docs/eval/`](https://github.com/apache/maka/tree/main/docs/eval) without restating numbers.
- The homepage, both READMEs and the repository description all open with the #4307 sentence: "Apache Maka (Incubating) is a high-performance agent workspace that keeps a complete record of everything it did." (#4686)

Tests in `website/test/site.test.mjs` hold the ASF-required parts, the bilingual link parity and that sentence, so they fail rather than drift.

## Remaining

- [ ] Run status semantics (#4423, #4424) are fixed, so the site does not describe more than the product records. Both are open and still in design.
- [ ] A fact-check cadence is recorded: the homepage is re-checked against the product at every release, and for changes to positioning, the primary journey, platform support, or the trust boundary.
- [ ] The PPMC records what happens to `maka-agent.com` and the GitHub Pages deployment. The direction settled is a redirect ([comment](https://github.com/apache/maka/issues/3404#issuecomment-5538543601)); the DNS and Pages changes are not made yet.

## Out of scope

- First-release artifact scope (#2974), the README and repository metadata of #3272 that #3391 advances, and Nightly delivery mechanics (#4301).
- Public governance decisions stay with the mentors and the PPMC; implementation ownership does not replace them.

AI use: I used Claude to draft this rewrite. I own the public change.

简体中文

属于 #2974,支撑 #3272(G5:孵化器品牌与发布面)。

**`maka.apache.org` 已经在提供 podling 官网。** 本 issue 负责发布链路和 ASF 政策要求的页面;官网讲什么由 #4307 定下。

## 已交付

- 站点源码在 `apache/maka` 的 `website/` 下,照 OpenDAL 的做法,不新建独立站点仓库。workflow 构建后强推到 `asf-site`,`.asf.yaml` 发布该分支,`staging: autostage: site/*` 为发版候选提供审查路径(#4660,2026-09-03 起上线)。
- 每个页面都标识 Apache Maka (Incubating),带完整 Incubator disclaimer 与 ASF 页脚,且不加载任何第三方资源。字体与资产有来源记录,站点具备 `LICENSE` 与 `NOTICE`。
- 下载页写明带签名的源码包才是 release,把 Desktop Nightly、源码构建与未来的 Apache Releases 分开,并给出 reviewer 投票前会实际执行的 `KEYS`、GPG 与 SHA-512 步骤。
- 首页中英两版章节、主张、警示与链接完全一致,由 @Astro-Han 负责同步。跑分板块链接 [`docs/eval/`](https://github.com/apache/maka/tree/main/docs/eval) 的报告,不复述数字。
- 首页、两份 README 和仓库描述都以 #4307 那句话开头:「Apache Maka(孵化中)是一个高性能的 Agent 工作台,并完整记录它做过的每一件事。」(#4686)

`website/test/site.test.mjs` 里的测试守住 ASF 要求的部分、中英链接对齐和这句话,漂移会直接失败而不是悄悄发生。

## 待办

- [ ] Run 状态语义(#4423、#4424)修好,使官网描述不超出产品实际记录。两个 issue 都还开着,仍在设计讨论中。
- [ ] 记录事实核对节奏:每次 release 都对照产品复核首页,定位、主要旅程、平台支持或信任边界变化时同样复核。
- [ ] PPMC 记录 `maka-agent.com` 与 GitHub Pages 部署的去向。已确定方向是跳转([评论](https://github.com/apache/maka/issues/3404#issuecomment-5538543601)),DNS 与 Pages 尚未修改。

## 不在范围内

- 首个 release 的 artifact 范围(#2974)、#3272 中由 #3391 推进的 README 与仓库元数据、Nightly 交付机制(#4301)。
- 公开治理决定仍归 mentor 与 PPMC,实现层面的负责不替代它们。

AI use:本次重写由我用 Claude 起草,我对这次公开改动负责。

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.