Refactor examples and enhance documentation in result.rs

[prorealize]

• Replaced map with map_err in the error handling example for correctness
• Reordered example code to improve readability and logical flow
• Added assertions to examples to demonstrate expected outcomes

[rustbot]

Thanks for the pull request, and welcome! The Rust team is excited to review your changes, and you should hear from @joboet (or someone else) some time within the next two weeks.

Please see the contribution instructions for more information. Namely, in order to ensure the minimum review times lag, PR authors and assigned reviewers should ensure that the review label (S-waiting-on-review and S-waiting-on-author) stays updated, invoking these commands when appropriate:

• @rustbot author: the review is finished, PR author should check the comments and take action accordingly
• @rustbot review: the author is ready for a review, this PR will be queued again in the reviewer's queue

[joboet]

Sure, why not! r=me¹ after the typo is fixed.

Footnotes

1. r=me is a shorthand we use to tell other reviewers that they can approve this on my behalf. You don't have to do anything about it. ↩

[joboet]

Thanks!
@bors r+ rollup

[bors]

📌 Commit e1611aa has been approved by joboet

It is now in the queue for this repository.

[bors]

⌛ Testing commit e1611aa with merge 4a78c00...

[bors]

☀️ Test successful - checks-actions
Approved by: joboet
Pushing 4a78c00 to master...

[rust-timer]

Finished benchmarking commit (4a78c00): comparison URL.

Overall result: ✅ improvements - no action needed

@rustbot label: -perf-regression

Instruction count

This is a highly reliable metric that was used to determine the overall result at the top of this comment.

	mean	range	count
Regressions ❌ (primary)	-	-	0
Regressions ❌ (secondary)	-	-	0
Improvements ✅ (primary)	-	-	0
Improvements ✅ (secondary)	-0.4%	[-0.5%, -0.4%]	2
All ❌✅ (primary)	-	-	0

Max RSS (memory usage)

Results (primary -2.5%)

This is a less reliable metric that may be of interest but was not used to determine the overall result at the top of this comment.

	mean	range	count
Regressions ❌ (primary)	-	-	0
Regressions ❌ (secondary)	-	-	0
Improvements ✅ (primary)	-2.5%	[-2.9%, -2.1%]	2
Improvements ✅ (secondary)	-	-	0
All ❌✅ (primary)	-2.5%	[-2.9%, -2.1%]	2

Cycles

This benchmark run did not return any relevant results for this metric.

Binary size

This benchmark run did not return any relevant results for this metric.

Bootstrap: 679.188s -> 679.603s (0.06%)
Artifact size: 316.03 MiB -> 316.12 MiB (0.03%)