Skip to content

Publish architecture guides as bilingual pairs - #43

Merged
novelKR merged 2 commits into
mainfrom
docs/architecture-guides
Sep 17, 2026
Merged

novelKR merged 2 commits into
mainfrom
docs/architecture-guides

Conversation

@novelKR

@novelKR novelKR commented Sep 17, 2026

Copy link
Copy Markdown
Owner

Issue

Closes #

Summary

The architecture group is now a reviewed bilingual set: architecture, execution-substrate, protocol-compatibility, and behavior-differences. Overview links those pages. The registry records IDs, groups, anchors, and hashes. Core protocol remains MCP 2025-11-25. The site still does not deploy from this PR.

Contract changes

None. No MCP tool schemas, error codes, or status values change.

Tests

Verified locally with Node 24.21.0 and Python 3.14:

python3.14 -B scripts/check_docs.py
npm run build --prefix docs-site
python3.14 -B docs-site/scripts/site.py check --commit "$(git rev-parse HEAD)"

site.py check --commit passed on a clean tree (91 hashed files, 21 HTML pages).

Security scenarios

  • third_party/codex sources are not site pages. The command_exec.rs citation remaps to a GitHub blob URL.
  • Product policy still rejects host-absolute paths, symlink follow, and silent git apply fallback in both languages.

Out of scope

  • Pages environment settings and live URL
  • Security and upstream group (security-model, runner-isolation, error-codes, codex-reuse, upstream-lock, upstream-update)
  • Publishing docs/workspaces.example.json as a site page

Made with Cursor

The architecture group records current layout, the execution-only
substrate, protocol baseline 2025-11-25, and product policy versus
crate defaults. Unpublished security and upstream files stay off the
site and remap to repository blob URLs.

Co-authored-by: Cursor <cursoragent@cursor.com>
Base automatically changed from docs/start-guides to main September 17, 2026 07:58
Docs CI does not check out the Codex submodule. Unpublished relative
links still become GitHub blob URLs instead of requiring the file on disk.

Co-authored-by: Cursor <cursoragent@cursor.com>
@novelKR
novelKR merged commit d8f1661 into main Sep 17, 2026
4 checks passed
@novelKR
novelKR deleted the docs/architecture-guides branch September 17, 2026 08:16
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.

1 participant