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.k...@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 _______________________________________________ pve-devel mailing list pve-devel@lists.proxmox.com https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel