Skip to content

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

Closed

Description

@Astro-Han
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 (feat(website): publish the podling site from website/ #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/ without restating numbers.
  • The homepage, both READMEs and the repository description all open with the [DISCUSS] Rebuild the Maka website and project narrative #4307 sentence: "Apache Maka (Incubating) is a high-performance agent workspace that keeps a complete record of everything it did." (docs: hand the landing-page role from the README to maka.apache.org #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

Out of scope

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/* 为发版候选提供审查路径(feat(website): publish the podling site from website/ #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/ 的报告,不复述数字。
  • 首页、两份 README 和仓库描述都以 [DISCUSS] Rebuild the Maka website and project narrative #4307 那句话开头:「Apache Maka(孵化中)是一个高性能的 Agent 工作台,并完整记录它做过的每一件事。」(docs: hand the landing-page role from the README to maka.apache.org #4686)

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

待办

不在范围内

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

Activity

  1. wy471x commented on Aug 25, 2026

    @wy471x

    I guess I could try.

  2. Astro-Han commented on Aug 25, 2026

    @Astro-Han
    ContributorAuthor

    hi @wy471x, thanks for initial the take.

    This issue is part of the Apache governance issue so it might be best leave to the current committee.

    There are issues with help-wanted tag, which are great start point for contribution. Would you be interested to look at those?

    Thanks!

  3. wy471x commented on Aug 25, 2026

    @wy471x

    hi @wy471x, thanks for initial the take.

    This issue is part of the Apache governance issue so it might be best leave to the current committee.

    There are issues with help-wanted tag, which are great start point for contribution. Would you be interested to look at those?

    Thanks!

    Alright, I can take a look.

  4. self-assigned this
    on Aug 25, 2026
  5. added theissue type on Aug 29, 2026
  6. changed the title [-]infra: publish the podling website at maka.apache.org from the existing Maka site[/-] [+]infra: publish the podling website at maka.apache.org[/+] on Aug 31, 2026
  7. Astro-Han commented on Sep 1, 2026

    @Astro-Han
    ContributorAuthor
    English

    Status: still 404, and the first exit criterion needs rewording

    https://maka.apache.org/ returns 404 as of 2026-09-01.

    The first exit criterion asks mentors to confirm how the site's code, copy, and design assets are covered — "by the software grant tracked in #3268 or by a separate Incubator IP clearance". #3268 has been proposed for closure (the software grant is an incubation setup item handled by the Incubator and the Secretary, not a release gate; evidence is on that issue). That does not remove this criterion, but it should stop pointing at #3268 for its answer.

    The question itself is still real and still needs a mentor: website code and design assets that were not part of the original donation need their own coverage before they move into an ASF repository. Suggest rewording it to ask mentors directly whether the site content falls under the existing grant or needs separate IP clearance, and tracking the answer here.

    Everything else on the list is unchanged. This issue is the real prerequisite for two of #3272's open criteria — the ASF-compliant download path and the incubating identification on the homepage — and #2974 now lists both in its non-blocking table, so neither gates RC1.

    One sequencing note: the downloads page cannot be finished before there is an approved source release to link, but its structure — KEYS link, SHA-512 and signature links, GPG and checksum verification steps, and the statement that convenience artifacts are not the release — can be built ahead of time against the staged candidate. OpenDAL's download.mdx is the reference this issue already names.

    简体中文

    进展:仍为 404,第一条出口条件需要改写

    截至 2026-09-01,https://maka.apache.org/ 返回 404。

    第一条出口条件要求导师确认站点的代码、文案和设计资产如何被覆盖——「由 #3268 跟踪的软件授权书,或由单独的孵化器 IP clearance」。#3268 已提议关闭(软件授权书是由孵化器和秘书处办理的入孵事项,不是发布门禁;证据在该 issue 上)。这并不取消本条,但它不应再指向 #3268 求答案。

    问题本身依然真实,也依然需要导师:不属于最初捐赠范围的网站代码和设计资产,在迁入 ASF 仓库之前需要各自的覆盖依据。建议改写为直接询问导师,站点内容是落在现有授权书之内,还是需要单独的 IP clearance,并把答复记录在本 issue。

    清单上其余各项无变化。本 issue 是 #3272 两条开放条件的实际前置——符合 ASF 的下载路径,以及首页的孵化标识——而 #2974 现已将两者列入非阻塞表,因此都不构成 RC1 的门槛。

    一条排序提示:下载页在有已获批准的源码发布可供链接之前无法完成,但它的结构——KEYS 链接、SHA-512 与签名链接、GPG 和校验和验证步骤,以及「convenience artifacts 不是发布」的声明——可以先针对暂存的候选包搭好。本 issue 已经点名的 OpenDAL download.mdx 就是参照。


    Drafted with help from Claude Code. I reviewed the final text and take responsibility for posting it.

  8. Astro-Han commented on Sep 3, 2026

    @Astro-Han
    ContributorAuthor
    English

    Status: live at maka.apache.org

    #4660 merged as 1fe21e6. The Website workflow built the site and force-pushed it to asf-site; asfyaml published it within three minutes. https://maka.apache.org/, /en/, /zh-CN/ and /en/downloads/ all return 200.

    Exit criteria now met, ticked in the body:

    • Site source in apache/maka under website/, following OpenDAL.
    • Workflow builds and pushes asf-site; the branch carries its own .asf.yaml with the publish: entry.
    • maka.apache.org serves the site.
    • Staging path exists: an -rc tag pushes site/<tag>-staging, and workflow_dispatch with stage=<name> pushes site/<name>-staging. Wired and covered by the workflow policy tests, not yet exercised against a real candidate.
    • Homepage identifies Apache Maka (Incubating) on first mention and carries the full disclaimer; every page carries the ASF footer; the site test asserts both.
    • Homepage uses the [DISCUSS] Rebuild the Maka website and project narrative #4307 positioning sentence.
    • Downloads page follows OpenDAL's download.mdx: KEYS, .asc, SHA-512, GPG and checksum steps, and it separates Desktop Nightly, source builds and Apache Releases, stating that convenience artifacts are not the release. Real artifact links wait for the first approved release.
    • Complete English and Chinese homepages sharing one Copy type; the build fails if either language misses a section or link.
    • Benchmarks block links to docs/eval/ without restating numbers in prose.
    • Fonts are Geist and Geist Mono from the @fontsource-variable packages, OFL-1.1, license text published under /licenses/; the logo is the README's sky.png; the Incubator logo is the ASF's published file. LICENSE and NOTICE ship in asf-site.

    Still open:

    简体中文

    进展:maka.apache.org 已上线

    #4660 以 1fe21e6 合并。Website workflow 构建站点并强推到 asf-site,asfyaml 在三分钟内发布。https://maka.apache.org/、/en/、/zh-CN/、/en/downloads/ 均返回 200。

    已满足并在正文勾选的出口条件:

    • 站点源码位于 apache/maka 的 website/,沿用 OpenDAL 布局。
    • workflow 构建并推送 asf-site;该分支自带含 publish: 的 .asf.yaml。
    • maka.apache.org 已提供该站点。
    • 暂存路径已就位:-rc tag 推送 site/<tag>-staging,workflow_dispatch 带 stage=<name> 推送 site/<name>-staging。已接线并有 workflow 策略测试覆盖,尚未对真实候选包演练。
    • 首页首次提及即为 Apache Maka (Incubating) 并带完整 disclaimer;每页带 ASF 页脚;站点测试对两者做断言。
    • 首页使用 [DISCUSS] Rebuild the Maka website and project narrative #4307 的定位句。
    • 下载页照 OpenDAL 的 download.mdx:KEYS、.asc、SHA-512、GPG 与校验步骤,并分开 Desktop Nightly、源码构建与 Apache Releases,声明 convenience artifacts 不是发布。真实制品链接等首个获批发布。
    • 中英首页完整并行,共用一个 Copy 类型;任一语言缺章节或链接则构建失败。
    • 基准块链接到 docs/eval/,不在正文复述数字。
    • 字体为 @fontsource-variable 的 Geist 与 Geist Mono,OFL-1.1,许可文本发布在 /licenses/;logo 为 README 的 sky.png;孵化器 logo 为 ASF 官方文件。LICENSE 与 NOTICE 随 asf-site 一起发布。

    仍开放:


    Drafted with help from Claude Code. I reviewed the final text and take responsibility for posting it.

  9. Astro-Han commented on Sep 4, 2026

    @Astro-Han
    ContributorAuthor

    Recording the direction settled for maka-agent.com and the GitHub Pages deployment, so it is not carried only in conversation.

    Redirect, not retire and not keep as a second site. Now that maka.apache.org serves the podling site, maka-agent.com and the GitHub Pages deployment redirect to it rather than continuing to serve their own copy of the project narrative. That keeps one place where the project describes itself, and it avoids a non-ASF domain presenting itself as the project's site, which is what the branding guide asks podlings to avoid.

    Execution is still open: the DNS and Pages changes have not been made, and the old content stays reachable until they are. I will follow up with the work item once the redirect target and the handling of existing paths are settled.

    If the PPMC wants this on the record as a formal decision rather than as a tracker note, it should go to the dev list; this comment is the tracker's copy of where we are.

    简体中文

    把 maka-agent.com 和 GitHub Pages 部署的处理方向记录在这里,不再只留在对话里。

    跳转,不下线,也不保留为第二个站点。 maka.apache.org 已经承载 podling 官网,maka-agent.com 与 GitHub Pages 部署改为跳转过去,不再各自维护一份项目叙述。这样项目只有一处自我描述,也避免一个非 ASF 域名以项目官网的身份出现——那正是品牌指南要求 podling 回避的情况。

    执行尚未完成:DNS 与 Pages 都还没有改,改完之前旧内容仍然可达。跳转目标与既有路径的处理方式确定后,我会跟进工作项。

    如果 PPMC 需要把这件事作为正式决定留档,而不只是 tracker 上的记录,应当走 dev 邮件列表;这条评论只是 tracker 这一侧的记录。

  10. Astro-Han commented on Sep 27, 2026

    @Astro-Han
    ContributorAuthor

    Closing: the goal of this issue is met. https://maka.apache.org/ has been live since #4660 (see the status comment above). The three unchecked items are not website infrastructure, so each goes to its own owner:

    中文

    关闭:本 issue 的目标已达成,https://maka.apache.org/ 自 #4660 起已上线(见上方状态评论)。剩下三项未勾选的都不属于官网基础设施,各归其主:

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

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentationtrackingTracking or umbrella issue

Type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions