Or at least, make it use this by default. The reason being that ByExtension() supports many more formats.

Document with markdown:
(samples could also be unit tests for some copy/pasting to make it easier to maintain when breaking changes occur)

• Basic Archive usage

• Basic Reader usage

• Basic Writer usage

• Options usage around leaving streams open

• Archive Encoding usage with auto-detect

The restore --target-action documentation states:

This option is effective when hot_standby=on is configured in postgresql.conf, otherwise the cluster will be promoted when the target is reached or there is no more WAL in the archive.

However, I don't believe this is accurate. In recent versi

Your default levels for ZSTD seem a little wonky:

• TURBO: ZSTD is missing, it should be -5 | --fast=5 (the fastest level currently available). This should push it into LZ4 territory.
• EFFICIENT should probably include 3, ZSTD's default level.
• OPTIMAL (meaning best trade off?) should probably be 20, as 22 balloons memory usa