docs(parser): improve docs for Token::read_bool

[overlookmotel]

Follow-on after #13867.

Correct the assembly examples. AI copied its invented assembly from #13788. Replace it with the actual assembly!

Also move the # SAFETY comment higher up, as that's more important than the perf analysis.

[overlookmotel]

• docs(parser): improve docs for Token::read_bool #13873 👈 (View in Graphite)
• main

---

How to use the Graphite Merge Queue

Add either label to this PR to merge it via the merge queue:

• 0-merge - adds this PR to the back of the merge queue
• hotfix - for urgent hot fixes, skip the queue and merge this PR next

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

This stack of pull requests is managed by Graphite. Learn more about stacking.

[Copilot]

Pull Request Overview

This PR improves the documentation for the Token::read_bool method by correcting inaccurate assembly examples and reorganizing the content for better clarity.

Key changes:

• Replace AI-generated assembly examples with actual assembly code from compiler output
• Move the safety documentation above performance analysis for better prioritization
• Add a link to Godbolt for verification of assembly examples

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[overlookmotel]

Merge activity

• Sep 18, 8:03 AM UTC: The merge label '0-merge' was detected. This PR will be added to the Graphite merge queue once it meets the requirements.
• Sep 18, 8:05 AM UTC: overlookmotel added this pull request to the Graphite merge queue.
• Sep 18, 8:14 AM UTC: Merged by the Graphite merge queue.

[codspeed-hq]

CodSpeed Instrumentation Performance Report

Merging #13873 will not alter performance

_{Comparing 09-18-docs_parser_improve_docs_for_token_read_bool_ (3a03b85) with main (57108c0)¹}

Summary

✅ 37 untouched

Footnotes

1. No successful run was found on main (8221a01) during the generation of this report, so 57108c0 was used instead as the comparison base. There might be some changes unrelated to this pull request in this report. ↩