[pbs-devel] [PATCH] docs: reword WORM tape documentation

[pbs-devel] [PATCH] docs: reword WORM tape documentation

[Aaron Lauterer]

Mainly splitting long sentences into smaller ones. Some rewording
happened in the process.

The changes should still transport the same information.

Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>
---
 docs/tape-backup.rst | 19 ++++++++++---------
 1 file changed, 10 insertions(+), 9 deletions(-)

diff --git a/docs/tape-backup.rst b/docs/tape-backup.rst
index a3a62818..f04b1284 100644
--- a/docs/tape-backup.rst
+++ b/docs/tape-backup.rst
@@ -1053,17 +1053,18 @@ This command does the following:
 WORM Tapes
 ----------
 
-WORM (write once, read many) tapes are special cartridges that cannot be deleted
-or overwritten, which may be useful for legal or protection purposes.
+WORM (write once, read many) tapes are special cartridges that cannot be
+deleted or overwritten. This may be useful for legal or protection purposes.
 
-Since they cannot be overwritten or deleted, if you want to use them, you must
-use a media pool with a retention policy of `keep`, otherwise a backup job
-potentially fails when trying to erase or overwrite it.
+If you want to use them, you must use a media pool with a retention policy of
+`keep`. Otherwise, a backup job can fail when it tries to erase or overwrite
+the tape.
+
+Proxmox Backup Server makes no distinction between normal and WORM tapes. To
+avoid confusion, use a different naming scheme for WORM backups and use
+dedicated media pools for them. Do not mix WORM and non-WORM tapes in the same
+media pool.
 
-Proxmox Backup Server does not handle WORM tapes differently, so it is
-recommended to use a different naming scheme, use only seperate media pools
-and not mix WORM and non-WORM tapes in a media pool together (since it may
-lead to confusion about which tapes are not overwritable).
 
 Example Setups
 --------------
-- 
2.30.2

Re: [pbs-devel] [PATCH] docs: reword WORM tape documentation

[Dominik Csapak]

LGTM

Reviewed-by: Dominik Csapak <d.csapak@proxmox.com>

[pbs-devel] applied: [PATCH] docs: reword WORM tape documentation

[Thomas Lamprecht]

Am 02/03/2023 um 12:18 schrieb Aaron Lauterer:
> Mainly splitting long sentences into smaller ones. Some rewording
> happened in the process.
> 
> The changes should still transport the same information.
> 
> Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>
> ---
>  docs/tape-backup.rst | 19 ++++++++++---------
>  1 file changed, 10 insertions(+), 9 deletions(-)
> 
>

applied, with Dominik's R-b, thanks!