Skip to content

Add multi-language architecture page, remove redundant TypeScript AppHost docs#563

Merged
IEvangelist merged 1 commit intorelease/13.2from
multilang-arch
Mar 19, 2026
Merged

Add multi-language architecture page, remove redundant TypeScript AppHost docs#563
IEvangelist merged 1 commit intorelease/13.2from
multilang-arch

Conversation

@davidfowl
Copy link
Contributor

Summary

Clean up the TypeScript AppHost documentation structure and add a multi-language architecture page.

Changes

Removed redundant pages

  • Deleted typescript-apphost.mdx — the first-app JavaScript pivot already covers this. The TypeScript AppHost is not special; it's just another way to write an AppHost.
  • Deleted typescript-apphost-troubleshooting.mdx — was an empty stub. Moved troubleshooting content to the general troubleshooting page.
  • Deleted typescript-apphost-migration.mdx — new content that doesn't need to exist yet.
  • Removed the "TypeScript AppHost" sidebar group entirely.

New page

  • Multi-language architecture (architecture/multi-language-architecture.mdx) — explains the guest/host model, ATS type system, SDK generation, polymorphism flattening, startup sequence, and connection security. Content sourced from the internal polyglot-apphost.md spec.

Other

  • Added TypeScript AppHost troubleshooting (command not found, SDK errors, debug mode, logs) to the general troubleshooting page.
  • Updated all cross-references (redirects, sidebar, link text).
  • Redirects only for URLs that existed in main (polyglot-*), not for new content.

@davidfowl davidfowl requested a review from IEvangelist as a code owner March 19, 2026 16:33
@IEvangelist
Copy link
Member

Hey @davidfowl, is this really intended - you deleted all the stuff you just added in an earlier PR.

…Host docs

- Delete typescript-apphost.mdx (first-app JS pivot covers this)
- Delete typescript-apphost-troubleshooting.mdx (empty stub)
- Delete typescript-apphost-migration.mdx (not needed yet)
- Remove TypeScript AppHost sidebar group
- Add multi-language architecture page under Architecture
  covering guest/host model, ATS type system, SDK generation,
  polymorphism flattening, startup sequence, token-based auth
- Move TS troubleshooting to general troubleshooting page
- Update all cross-references and redirects

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@davidfowl
Copy link
Contributor Author

Yep. Changes the framing.

@IEvangelist IEvangelist merged commit 30910eb into release/13.2 Mar 19, 2026
1 check passed
@IEvangelist IEvangelist deleted the multilang-arch branch March 19, 2026 20:39
IEvangelist added a commit that referenced this pull request Mar 20, 2026
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