docs: clarify docker-driver gateway topology

[WuKongAI-CMU]

Summary

Clarifies the deployment topology docs now that Linux and Apple Silicon macOS use the OpenShell Docker-driver gateway path by default, while legacy k3s wording only applies to legacy paths such as Windows through WSL2.

Changes

• Add a platform-to-compute-model table to the architecture reference.
• Scope memory and Docker storage-driver notes so k3s is only described for legacy gateway paths.
• Align quickstart and prerequisites wording with the tested Apple Silicon macOS Docker-driver path.
• Move the Linux newgrp docker recovery command back under the Linux installer guidance.

Type of Change

• Code change (feature, bug fix, or refactor)
• Code change with doc updates
• Doc only (prose changes, no code sample modifications)
• Doc only (includes code sample changes)

Verification

• npx prek run --all-files passes
• npm test passes
• Tests added or updated for new or changed behavior
• No secrets, API keys, or credentials committed
• Docs updated for user-facing behavior changes
• make docs builds without warnings (doc changes only)
• Doc pages follow the style guide (doc changes only)
• New doc pages include SPDX header and frontmatter (new pages only)

Additional focused check: python3 scripts/docs-to-skills.py docs/ .agents/skills/ --prefix nemoclaw-user --dry-run.

---

Signed-off-by: Intern Dev dev@wukongai.io

[copy-pr-bot]

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: a2f64c97-d925-4a67-8078-0000cf049a1a

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[miyoungc]

Docs migration heads-up: #3837 has merged the Fern MDX migration cleanup.

Legacy documentation source pages under docs/**/*.md have been removed, except for docs/CONTRIBUTING.md. Please update this PR so any documentation changes target the matching Fern MDX page under docs/**/*.mdx instead, for example docs/reference/commands.mdx or docs/inference/inference-options.mdx.

CI now validates the MDX sources directly, so deleted legacy Markdown pages should stay deleted.

[apurvvkumaria]

Thanks @WuKongAI-CMU for identifying the Docker-driver versus legacy-k3s documentation distinction. The original commit remains attributed to Intern Dev dev@wukongai.io.

Maintainer audit completed against current main at fed4604:

• This draft edits only the retired docs/**/*.md sources. PR docs: remove legacy markdown docs and refresh MDX checks #3837 removed those files during the Fern MDX migration, and GitHub now reports this branch as conflicting.
• The underlying issue, [Docs] architecture.md and prerequisites.md still describe only the legacy k3s path; Docker driver default landed in 0.0.39 #3432, was closed as completed after docs: update deployment topology diagram #4028 merged.
• Current docs/reference/architecture.mdx already states that the default Linux and Apple Silicon macOS path uses a Docker-driver sandbox container and that k3s applies to the legacy non-Docker-driver path.
• Current docs/get-started/quickstart.mdx already keeps the newgrp recovery under Linux guidance and documents the macOS Docker-driver path.
• I also audited the remaining prerequisites/troubleshooting memory wording. PR docs: update prerequisites Docker-driver wording #4165 proposed the matching MDX follow-up and was explicitly closed by maintainers as redundant after docs: update deployment topology diagram #4028, so recreating that patch would reopen work the project has already marked resolved.
• There is no linked open issue to assign. The only commit on this draft is not GitHub Verified, CodeRabbit skipped the draft, and the normal current CI gate never ran.

Closing as obsolete/superseded, without merge. No contributor code was copied into a replacement commit, so no new co-author trailer is needed; the original author credit is preserved here in the PR and commit history.