docs: Add troubleshooting guide for fat LTO miscompilation

[zouguangxian]

Description

Adds docs/troubleshooting.md documenting a known fat LTO miscompilation that causes zkvm::lookup_table::equal::test::prefix_suffix to fail under --release. This class of issue is tracked upstream in rust-lang/rust#116941.

What's covered

• Quick workaround summary — prefer lto = "thin" (the default), or use RUSTFLAGS="-C no-prepopulate-passes" if fat LTO is required.
• Detailed configuration matrix with reproduction commands and exact error output for:
  1. lto = "fat" — triggers the miscompile (prefix_suffix assertion failure).
  2. lto = "thin" — recommended, all tests pass.
  3. lto = "fat" + -C no-prepopulate-passes — avoids the miscompile but may increase trace lengths, causing advice_e2e_dory to fail unless max_trace_length is bumped (e.g. 1 << 16 → 1 << 17).

[sagar-a16z]

maybe we should create an outstanding issue that tracks the upstream rust issue. So we can keep track of when this sensitivity goes away.

[moodlezoup]

let's move this into the existing troubleshooting page: https://github.com/a16z/jolt/blob/main/book/src/usage/troubleshooting.md

[zouguangxian]

let's move this into the existing troubleshooting page: https://github.com/a16z/jolt/blob/main/book/src/usage/troubleshooting.md

migrated