docs(linux): add AppImage failure notes

[aqilaziz]

Summary

• document known Linux AppImage startup symptoms such as unshare uid_map failures, Interpreter not found, and cannot execute binary file
• point Debian/Ubuntu users to the .deb package when AppImage startup is blocked by host restrictions
• list diagnostics maintainers need for Fedora/openSUSE/non-Debian reports

Refs #2368
Refs #2380
Refs #2231

Checks

• git diff --check

Summary by CodeRabbit

• Documentation
  • Added comprehensive Linux AppImage documentation including platform specifications (x64-targeted, default asset for curl installer), common startup failure scenarios with root causes (namespace/permission issues, missing interpreter, execution errors), recommended troubleshooting steps (fallback to .deb on Debian/Ubuntu systems), and required diagnostic information for issue reporting.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: dc178d30-60fa-427f-b071-8abceba26267

📥 Commits

Reviewing files that changed from the base of the PR and between 369a392 and 764a787.

📒 Files selected for processing (1)

• gitbooks/features/platform.md

---

📝 Walkthrough

Walkthrough

The gitbooks/features/platform.md documentation file is extended with a new "Linux AppImage notes" section that provides AppImage-specific behavior details, failure symptom recognition, troubleshooting guidance for Debian/Ubuntu users, and a diagnostic checklist for issue reports on other distributions.

Changes

Linux AppImage Documentation

Layer / File(s)	Summary
Linux AppImage notes section gitbooks/features/platform.md	New section clarifying that the Linux AppImage targets x64 and is the default asset for the curl installer. Describes common failure symptoms (namespace permissions, missing interpreter, execution errors), recommends .deb package for Debian/Ubuntu users, and requests distro/kernel version, GPU/driver stack, and filename details when reporting AppImage issues on other distributions.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐰 A document grows with guidance new,
AppImage notes for folks like you—
What x64 means, where to find,
Troubleshooting tips, all well-designed,
Users helped, bug reports refined! 📚

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'docs(linux): add AppImage failure notes' directly and clearly summarizes the main change: adding documentation about AppImage failure symptoms and troubleshooting for Linux users.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

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

[graycyrus]

Looks good, nice work!