mirrors/maka

0 Fork 0

mirror of https://github.com/apache/maka.git synced 2026-10-28 17:04:39 +08:00

Files

T

History

Sherlock YinandClaude Code f87c82df46 docs: fix unrendered bold, stale names, and stale values (#5625 )

- Bold closed right after a full-width colon and before a letter is not
  right-flanking under CommonMark, so GitHub and npm print the asterisks.
  Move the colon outside the emphasis in the CLI Chinese README, the
  agent-graph scheduling draft, and the Chinese Nightly npm notice.
- ARCHITECTURE.zh-CN.md: `Runtime Runner` -> `RuntimeKernel`, and
  `[ENGLISH]` -> `[English]`.
- agent-swarm.md: `AiSdkTurn`, not `AiSdkBackend`, appends the swarm prompt.
- README native/ entry: name the Windows Runtime Host task launcher.
- DESIGN.md: drop `info-light`/`info-dark` (the document states there is no
  info colour), correct `surface-overlay-dark` to the derived 0.223, and
  repair the unparseable `--warning` sentence.
- ui README: five export surfaces, not four.
- cli-npm-release: drop the stray `version=0.1.0` from the dist-tags step.
- ACP README: state the 175 -> 176 epoch bump as past (#5386).
- eval README: `machine path ... is unavailable` means the env var is unset;
  refresh stale install-preflight line references.
- website README: the published .asf.yaml also sets `staging.profile: ~`.

Fixes #5624

Generated-by: Claude Code
Co-Authored-By: Claude Code <noreply@anthropic.com>

2026-10-10 20:55:54 +10:00

public

feat(website): add machine-readable discovery files (#5636 )

2026-09-24 09:29:41 +08:00

scripts

feat(website): carry link-preview tags on every page (#4813 )

2026-09-05 22:26:54 +08:00

src

docs(website): list the 0.2.0 release on the downloads page (#5983 )

2026-10-08 17:56:21 +08:00

test

feat(website): add machine-readable discovery files (#5636 )

2026-09-24 09:29:41 +08:00

astro.config.mjs

feat(website): publish the podling site from website/ (#4660 )

2026-09-04 02:36:47 +08:00

package.json

chore(deps): refresh patches after dependency upgrades (#5839 )

2026-09-30 01:23:39 +08:00

README.md

docs: fix unrendered bold, stale names, and stale values (#5625 )

2026-10-10 20:55:54 +10:00

tsconfig.json

feat(website): publish the podling site from website/ (#4660 )

2026-09-04 02:36:47 +08:00

README.md

maka.apache.org

The podling website: a bilingual homepage and a downloads page, built with Astro and published through .asf.yaml. Docs, security policy, community, releases and architecture stay authoritative where they already live in this repository; the site links to them and copies nothing.

npm --workspace @maka/website run dev    # http://localhost:4321/en/
npm --workspace @maka/website run build  # website/dist
npm --workspace @maka/website run test:dist

Content

The positioning sentence and homepage direction (Astryx Centered Hero) follow the consensus in #4307. Public download calls to action lead to approved releases, or the current release status until one is available. Contributor setup and testing instructions live in CONTRIBUTING; the site does not promote Nightly installers to general users. See the ASF publication policy.
English and Chinese are one page each in src/copy/. Both share the Copy type in src/copy/types.ts, so a section, claim or link added to one language fails to type-check until the other has it too, and test/site.test.mjs asserts the built pages link the same documents. Yuhan Lei (@Astro-Han) keeps the two in sync.
Numbers on the homepage are drawn from the reports in docs/eval/ and link to them. The reports own the numbers.
Fact-check cadence: the homepage is re-read against the product at every release, and whenever the positioning, the primary journey, platform support or the trust boundary changes. The README's Get Maka section, SECURITY.md and docs/eval/ are the sources to check against.
Machine-readable entry points live in public/: page changes must update sitemap.xml, and authoritative document changes must update llms.txt. The latter links to raw Markdown in the repository rather than copying documentation into the site.

Design

Colour, radius and surface tokens are the desktop app's defaults, copied by value from apps/desktop/src/renderer/maka-tokens.css into src/styles/site.css. The site follows the viewer's colour scheme until they pick one with the toggle in the top bar, which is remembered in that browser. Fonts are Geist and Geist Mono (SIL Open Font License 1.1), self-hosted from the @fontsource-variable packages the desktop app already depends on, with each package's OFL text published at /licenses/<package>/LICENSE; nothing loads from a third party. The logo is apps/desktop/assets/app-icons/sky.png, the same file the README uses. src/assets/incubator.png is the Apache Incubator logo as published at https://www.apache.org/logos/res/incubator/default.png, an ASF trademark used here as the Incubator branding guide asks; it is not edited.

Publishing

.github/workflows/website.yml builds the site and pushes website/dist plus LICENSE, NOTICE and a site-only .asf.yaml as an orphan commit:

Trigger	Branch	Served at
Push to `main` touching the site	`asf-site`	https://maka.apache.org
Push of a release-candidate tag (`v-rc`)	`site/<tag>-staging`	https://maka-.staged.apache.org
`workflow_dispatch` with a `stage` name	`site/<stage>-staging`	https://maka-.staged.apache.org

A workflow_dispatch without a stage name publishes only from main; any other ref fails instead of overwriting the live site. The published .asf.yaml carries just publish: whoami: asf-site and staging: profile: ~, autostage: site/*, the same layout Apache OpenDAL uses; the repository settings in the root .asf.yaml stay on main, the only branch asfyaml reads them from. Nothing else in the repository is published.