Document how replacing an encoding works in edition

[robert3005]

Need to audit the wording in all the places still

[codspeed-hq]

Merging this PR will improve performance by 21.22%

⚠️ 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

⚡ 5 improved benchmarks
✅ 2194 untouched benchmarks
⏩ 206 skipped benchmarks¹

Performance Changes

	Mode	Benchmark	BASE	HEAD	Efficiency
⚡	WallTime	arrow_checked_add_u32_neon[16384]	20.5 µs	12.9 µs	+58.82%
⚡	Simulation	decompress[u64, (4000, 1024)]	85.5 µs	70.4 µs	+21.48%
⚡	Simulation	allocate_drop_bytes[0]	520.2 ns	466 ns	+11.62%
⚡	WallTime	filtered_sink_i64_neon[NineNullsInTen]	28 µs	25.4 µs	+10.29%
⚡	WallTime	filtered_owned_i64_neon[NineNullsInTen]	28 µs	25.4 µs	+10.22%

Tip

Curious why performance improved? Comment @codspeedbot explain why performance improved on this PR, or directly use the CodSpeed MCP with your agent.

---

_{Comparing rk/editionsreplacement (9cf76ef) with develop (6d0adab)}

Footnotes

1. 206 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. ↩