Add troubleshooting guide for common build and installation errors

[5Palak-Garg]

Problem

The project provides installation and build instructions, but it lacks a dedicated troubleshooting section for common issues that contributors may encounter while setting up the project.

Common problems such as:

• Rust toolchain version mismatch
• Cargo dependency resolution errors
• Missing system dependencies
• Python binding build failures
• Platform-specific build issues

can make onboarding difficult for new contributors.

Proposed Solution

Add a "Troubleshooting" section to the documentation that includes:

• Common build errors
• Possible causes
• Recommended fixes
• Platform-specific notes (Windows/Linux/macOS)
• Helpful Cargo commands for debugging

Benefits

• Better contributor onboarding
• Reduced repetitive support questions
• Easier setup for GSSoC participants
• Improved developer experience

I would like to work on this issue under GSSoC 2026.

[Gitanshika]

/assign

please assign me under gssoc 2026

[github-actions]

Usage: /assign. Contributors can only assign themselves.

[github-actions]

Assigned to @Gitanshika.