New Old World documentation¶
New Old World connects a modern macOS host to a classic Macintosh. The modern Mac supplies native browsing, services, and agent integration; the classic Mac supplies its own files, processes, screen, software inventory, and human-facing Workshop. They meet through one versioned contract.
The alpha targets the PowerPC Carbon guest. The pre-Carbon NOW-68K source remains in the repository, but its current build is stale and is not planned for the alpha. The alpha feature profile is the authoritative release-facing statement.
Start here¶
- Connect your first classic Mac for the guided path from artifacts to a named session.
- Set up a new PowerPC Mac to have the host build and serve a personalized classic setup disk.
- Explore core features and Extension coverage after connecting, including which features work without the optional component and which remain experimental.
- Review alpha features for what is included, optional, and excluded.
- Browse the module reference when you already have a connection and want to understand one surface.
- Read the developer orientation before digging into the source, contracts, guests, resident components, or gates.
Pre-alpha posture¶
The documentation uses the same evidence vocabulary as the repository: Builds, Tested, Emulator-verified, and Metal-verified are different claims. A feature described here may still be experimental or unverified on one guest. Read current limitations before putting irreplaceable data or an untrusted network in the loop.
Documentation map¶
- The user guide contains one tutorial, outcome-oriented how-to guides, explanations, and reference pages.
- The developer guide explains how the code works, how to trace and debug it, and why its contracts and verification boundaries exist.
- Engineering records preserve status, measurements, known-wrong behavior, and the append-only issue ledger. They are evidence, not first-run prose. Current summaries remain searchable; linked deep records and the append-only ledger keep stable URLs but stay out of primary search results.
Contributing¶
The contributing guide covers the project contribution path. Coding agents should enter through the lower agent guide, which adds repository operating, routing, evidence, and handoff rules while linking back to the same developer documentation for technical explanations.