Document how replacing an encoding works in edition

[robert3005]

Need to audit the wording in all the places still

[codspeed]

Merging this PR will degrade performance by 8.15%

⚠️ Unknown Walltime execution environment detected

Using the Walltime instrument on standard Hosted Runners will lead to inconsistent data.

For the most accurate results, we recommend using CodSpeed Macro Runners: bare-metal machines fine-tuned for performance measurement consistency.

⚠️ Different runtime environments detected

Some benchmarks with significant performance changes were compared across different runtime environments,
which may affect the accuracy of the results.

Open the report in CodSpeed to investigate

⚡ 3 improved benchmarks
❌ 4 regressed benchmarks
✅ 2246 untouched benchmarks
⏩ 218 skipped benchmarks¹

Warning

Please fix the performance issues or acknowledge them on CodSpeed.

Performance Changes

	Mode	Benchmark	BASE	HEAD	Efficiency
❌	WallTime	arrow_checked_add_u32_neon[16384]	12.3 µs	20.3 µs	-39.56%
❌	Simulation	take_map[(0.1, 0.5)]	155.8 µs	191.3 µs	-18.57%
❌	Simulation	take_map[(0.1, 1.0)]	229.3 µs	269.4 µs	-14.87%
❌	WallTime	dbp_split_kernel_mixed_null_neon[(I256, 1024)]	1.9 µs	2.2 µs	-12.54%
⚡	Simulation	allocate_drop_bytes[0]	635.5 ns	527.2 ns	+20.55%
⚡	WallTime	mul_i16_nonnull_avx512	8 µs	7.1 µs	+13%
⚡	WallTime	mul_u32_nonnull_avx512	6.3 µs	5.7 µs	+10.47%

Tip

Investigate this regression by commenting @codspeedbot fix this regression on this PR, or directly use the CodSpeed MCP with your agent.

---

_{Comparing rk/editionsreplacement (ab21a3b) with develop (c6678f3)}

Footnotes

1. 218 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩