[pve-devel] [PATCH docs 1/3] storage: make description of storage CLI examples more consistent
Daniel Kral
d.kral at proxmox.com
Tue Mar 4 11:09:13 CET 2025
Make the text for `pvesm scan` and `pvesm add` command examples more
consistent by introducing `pvesm scan` with "You can get ... with", as
it is already done for other storage plugins, and changing from past
tense to present tense in existing descriptions for the `pvesm add` as
recommended in the Technical Writing Style Guide for instructions [0].
While at it, replace the term "share" with the more appropriate
"datastore" for the example in the PBS section.
[0] https://pve.proxmox.com/wiki/Technical_Writing_Style_Guide#Second_person_imperative_mood
Signed-off-by: Daniel Kral <d.kral at proxmox.com>
---
pve-storage-cifs.adoc | 2 +-
pve-storage-iscsi.adoc | 2 +-
pve-storage-lvm.adoc | 2 +-
pve-storage-lvmthin.adoc | 2 +-
pve-storage-pbs.adoc | 4 ++--
5 files changed, 6 insertions(+), 6 deletions(-)
diff --git a/pve-storage-cifs.adoc b/pve-storage-cifs.adoc
index d5d54e7..6b8f35d 100644
--- a/pve-storage-cifs.adoc
+++ b/pve-storage-cifs.adoc
@@ -110,7 +110,7 @@ You can get a list of exported CIFS shares with:
# pvesm scan cifs <server> [--username <username>] [--password]
----
-Then you could add this share as a storage to the whole {pve} cluster
+Then you can add one of these shares as a storage to the whole {pve} cluster
with:
----
diff --git a/pve-storage-iscsi.adoc b/pve-storage-iscsi.adoc
index 55e5b21..aea26d2 100644
--- a/pve-storage-iscsi.adoc
+++ b/pve-storage-iscsi.adoc
@@ -81,7 +81,7 @@ storage on that iSCSI LUN.
Examples
~~~~~~~~
-Scan a remote iSCSI portal, and returns a list of possible targets:
+You can scan a remote iSCSI portal and get a list of possible targets with:
pvesm scan iscsi <HOST[:PORT]>
diff --git a/pve-storage-lvm.adoc b/pve-storage-lvm.adoc
index 487aac6..c100d56 100644
--- a/pve-storage-lvm.adoc
+++ b/pve-storage-lvm.adoc
@@ -88,7 +88,7 @@ not support shared storage.
Examples
~~~~~~~~
-List available volume groups:
+You can get a list of available LVM volume groups with:
# pvesm lvmscan
diff --git a/pve-storage-lvmthin.adoc b/pve-storage-lvmthin.adoc
index f18af63..28ff55f 100644
--- a/pve-storage-lvmthin.adoc
+++ b/pve-storage-lvmthin.adoc
@@ -76,7 +76,7 @@ multiple nodes, so you can only use them as local storage.
Examples
~~~~~~~~
-List available LVM thin pools on volume group `pve`:
+You can get a list of available LVM thin pools on the volume group `pve` with:
# pvesm lvmthinscan pve
diff --git a/pve-storage-pbs.adoc b/pve-storage-pbs.adoc
index d65448d..fafc9c3 100644
--- a/pve-storage-pbs.adoc
+++ b/pve-storage-pbs.adoc
@@ -164,8 +164,8 @@ Example: Add Storage over CLI
//# pvesm scan pbs <server> [--username <username>] [--password]
//----
-Then you could add this share as a storage to the whole {pve} cluster
-with:
+Then you can add one of these datastores as a storage to the whole {pve}
+cluster with:
----
# pvesm add pbs <id> --server <server> --datastore <datastore> --username <username> --fingerprint 00:B4:... --password
--
2.39.5
More information about the pve-devel
mailing list