From 76a9a5d4a51b378d4b11b9f04cda212480ffa83b Mon Sep 17 00:00:00 2001
From: ymote <151983+ymote@users.noreply.github.com>
Date: Sat, 26 Sep 2026 15:15:26 -0700
Subject: [PATCH] Docs: contestant pointer; name the runtime's real consumers

Hackathon docs audit.

- README.md / README.zh-CN.md: add a "Building an OctoSense app?" note under the language switcher: a contestant does not need this repository (it is a research renderer for native Android widgets, separate from script apps and the App Hub) and the org profile's reading order.
- The pointer to the full analysis in octos-one now says that repository is not public.
- "AppCards" (the old name of OctoScript-App-Design-Flow) replaced by the consumers the org profile names: the OctoSense shells and the App Hub's `card-host`.

The runtime lock itself points at an OctoScript-Makepad commit that is not on main; that is a build change, filed as #4.

Docs only.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 README.md       | 9 ++++++---
 README.zh-CN.md | 6 ++++--
 2 files changed, 10 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 4bdd7dc..e88ca17 100644
--- a/README.md
+++ b/README.md
@@ -2,12 +2,15 @@
 
 English | [简体中文](README.zh-CN.md)
 
+> **Building an OctoSense app?** You do not need this repository: it renders OctoScript to native Android widgets as a research renderer, a separate path from OctoSense script apps and the App Hub. Start from the [OctoSense organization profile](https://github.com/OctoSense-org)'s reading order: [OctoScript-App-Design-Flow `AGENTS.md`](https://github.com/OctoSense-org/OctoScript-App-Design-Flow/blob/main/AGENTS.md) → [`flows/README.md`](https://github.com/OctoSense-org/OctoScript-App-Design-Flow/blob/main/flows/README.md) → [`docs/QUICKSTART.md`](https://github.com/OctoSense-org/OctoScript-App-Design-Flow/blob/main/docs/QUICKSTART.md).
+
 ## Shared Octoscript-Makepad runtime
 
 `native-runtime.lock.json` selects one
 [Octoscript-Makepad](https://github.com/OctoSense-org/Octoscript-Makepad)
 release. Its `runtime.json` owns the exact Makepad and Octoscript revisions,
-shared with AppCards, Mail and the other OctoSense applications.
+shared with the OctoSense shells, the App Hub's `card-host`, Mail and the other
+OctoSense applications.
 
 Before building, run `python3 tools/setup-native.py` (Python 3.9+). The framework
 repositories are siblings of this app: `../octoscript-makepad`, `../makepad`
@@ -56,8 +59,8 @@ managed object. So Octoscript-OH's 2.5–3× construction win does not transfer,
 design goal here is *minimising boundary crossings*, not avoiding managed-language
 objects.
 
-See `docs/` in octos-one (`OCTOSCRIPT-ANDROID-NATIVE-WIDGETS.md`) for the full
-analysis.
+The full analysis (`OCTOSCRIPT-ANDROID-NATIVE-WIDGETS.md`) is in octos-one, which
+is not a public repository.
 
 ## catalog/
 
diff --git a/README.zh-CN.md b/README.zh-CN.md
index ca41711..e0da775 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -2,12 +2,14 @@
 
 [English](README.md) | 简体中文
 
+> **要开发 OctoSense 应用？** 你不需要这个仓库：它是把 OctoScript 渲染为 Android 原生控件的研究型渲染器，与 OctoSense 脚本应用和 App Hub 是两条不同的路径。请按 [OctoSense 组织主页](https://github.com/OctoSense-org)给出的顺序阅读：[OctoScript-App-Design-Flow `AGENTS.md`](https://github.com/OctoSense-org/OctoScript-App-Design-Flow/blob/main/AGENTS.md) → [`flows/README.md`](https://github.com/OctoSense-org/OctoScript-App-Design-Flow/blob/main/flows/README.md) → [`docs/QUICKSTART.md`](https://github.com/OctoSense-org/OctoScript-App-Design-Flow/blob/main/docs/QUICKSTART.md)。
+
 ## 共享的 Octoscript-Makepad 运行时
 
 `native-runtime.lock.json` 选定一个
 [Octoscript-Makepad](https://github.com/OctoSense-org/Octoscript-Makepad)
 发布版本。该版本的 `runtime.json` 负责锁定确切的 Makepad 和 Octoscript 版本，
-AppCards、Mail 以及其他 OctoSense 应用共用同一份。
+OctoSense 外壳、App Hub 的 `card-host`、Mail 以及其他 OctoSense 应用共用同一份。
 
 构建之前先运行 `python3 tools/setup-native.py`（需要 Python 3.9+）。框架仓库与本应用
 并列存放：`../octoscript-makepad`、`../makepad` 和 `../octoscript`。本地改动会被保留；
@@ -55,7 +57,7 @@ OpenHarmony 提供 `arkui/native_node.h`——一套用于构建控件的 C NDK
 托管对象之下没有原生层。因此 Octoscript-OH 那 2.5–3 倍的构建速度优势无法照搬过来；
 这里的设计目标是*尽量减少跨边界调用*，而不是避开托管语言对象。
 
-完整分析见 octos-one 的 `docs/`（`OCTOSCRIPT-ANDROID-NATIVE-WIDGETS.md`）。
+完整分析（`OCTOSCRIPT-ANDROID-NATIVE-WIDGETS.md`）在 octos-one 中，该仓库未公开。
 
 ## catalog/