Skip to content

docs: connect project metadata to public website - #2924

Draft
hqhq1025 wants to merge 1 commit into
mainfrom
codex/seo-geo-foundation
Draft

docs: connect project metadata to public website#2924
hqhq1025 wants to merge 1 commit into
mainfrom
codex/seo-geo-foundation

Conversation

@hqhq1025

@hqhq1025 hqhq1025 commented Aug 12, 2026

Copy link
Copy Markdown
Contributor

Status

Draft. This PR depends on the unfinished website page work in maka-agent/maka-agent.github.io#1. The website PR now includes the complete page inventory, planned public URLs, desktop/mobile screenshots, and an explicit design/content revision checklist.

Do not merge this PR before the website pages are redesigned, reviewed, merged, and deployed; otherwise the new README links will point to 404 routes.

Summary

  • add first-screen links to the official website, download, documentation, architecture, and latest release
  • update English and Chinese download guidance to reflect the current signed Apple Silicon macOS build and unsigned Windows x64 preview
  • add repository-facing package metadata: description, homepage, repository, issue tracker, and discovery keywords
  • link the documentation authority map to the public project pages

Verification

  • git diff --check
  • parsed package.json and package-lock.json successfully
  • all 12 GitHub checks passed

Maintainer follow-up

The current account can push code but cannot update repository settings. After the website and this PR are ready, please set:

  • GitHub Homepage: https://maka-agent.com/
  • Topics: ai-agent, desktop-app, local-first, agent-runtime, electron, typescript, cli, tui, open-source

GitHub returned a permission-masked 404 when those settings were attempted through the API; they were not changed.

@jackwener jackwener left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Automated review of exact head c21859edb1f6ca7dcfbf3780408cdf022d0f93f0 against current main@d62857a8357e9160926726a2a13096bc2dc2b91d.

I included this as a documentation/metadata repair by another committer. Its original missing-link problem is real, but the proposed revision is now superseded by the Apache migration and should not be revived through conflict resolution.

Blocking: every new public authority still points at the pre-Apache project. The README navigation and package metadata publish maka-agent.com plus github.com/maka-agent/maka-agent; current main is apache/maka, .asf.yaml names Apache Maka (Incubating), and the open branding repair targets maka.apache.org. Merging these values would re-establish the obsolete project/domain as the package homepage, issue tracker, download authority, and documentation authority. The PR body also explicitly says its prerequisite website pages are unfinished and the links would otherwise be 404s.

Required conclusions:

  1. Optimal for the actual problem: no longer; the ownership/domain premise changed.
  2. Production code to delete: none; this is metadata/docs only.
  3. Tests to delete/replace: none identified.
  4. Deeper refactor: no—close this revision or rewrite it narrowly against the approved ASF website/download authorities after they exist.
  5. Ready to merge: no; it is Draft, conflicting, and depends on an obsolete/unshipped website surface.
  6. Residual risks/gaps: website, release/download wording, trademarks, and project metadata are governance/release surfaces requiring PPMC/mentor review and live link verification.

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