@@ -66,8 +66,9 @@ All pins must be attached to a volume. And all volumes must be attached to a Pro
6666
6767func ipfsVolumeCreate () * core.Command {
6868 return & core.Command {
69- Short : `Create a new volume from a Project ID. Volume is identified by an ID and used to host pin references` ,
70- Long : `Volume is personal (at least to your organization) even if IPFS blocks and CID are available to anyone.
69+ Short : `Create a new volume` ,
70+ Long : `Create a new volume from a Project ID. Volume is identified by an ID and used to host pin references.
71+ Volume is personal (at least to your organization) even if IPFS blocks and CID are available to anyone.
7172Should be the first command you made because every pin must be attached to a volume.` ,
7273 Namespace : "ipfs" ,
7374 Resource : "volume" ,
@@ -97,7 +98,7 @@ Should be the first command you made because every pin must be attached to a vol
9798
9899func ipfsVolumeGet () * core.Command {
99100 return & core.Command {
100- Short : `Retrieve information about a specific volume` ,
101+ Short : `Get information about a volume` ,
101102 Long : `Retrieve information about a specific volume.` ,
102103 Namespace : "ipfs" ,
103104 Resource : "volume" ,
@@ -126,7 +127,7 @@ func ipfsVolumeGet() *core.Command {
126127
127128func ipfsVolumeList () * core.Command {
128129 return & core.Command {
129- Short : `Retrieve information about all volumes from a Project ID` ,
130+ Short : `List all volumes by a Project ID` ,
130131 Long : `Retrieve information about all volumes from a Project ID.` ,
131132 Namespace : "ipfs" ,
132133 Resource : "volume" ,
@@ -166,7 +167,7 @@ func ipfsVolumeList() *core.Command {
166167
167168func ipfsVolumeUpdate () * core.Command {
168169 return & core.Command {
169- Short : `Update volume information (tag, name...) ` ,
170+ Short : `Update volume information` ,
170171 Long : `Update volume information (tag, name...).` ,
171172 Namespace : "ipfs" ,
172173 Resource : "volume" ,
@@ -207,8 +208,8 @@ func ipfsVolumeUpdate() *core.Command {
207208
208209func ipfsVolumeDelete () * core.Command {
209210 return & core.Command {
210- Short : `Delete a volume by its ID and every pin attached to this volume. Can take a while, depending of your pinned content ` ,
211- Long : `Delete a volume by its ID and every pin attached to this volume. Can take a while, depending of your pinned content.` ,
211+ Short : `Delete an existing volume` ,
212+ Long : `Delete a volume by its ID and every pin attached to this volume. This process can take a while to conclude , depending on the size of your pinned content.` ,
212213 Namespace : "ipfs" ,
213214 Resource : "volume" ,
214215 Verb : "delete" ,
@@ -242,8 +243,9 @@ func ipfsVolumeDelete() *core.Command {
242243
243244func ipfsPinCreateByURL () * core.Command {
244245 return & core.Command {
245- Short : `Create a pin request. Will fetch and store the content pointed by the provided URL. The content must be available on the public IPFS network` ,
246- Long : `The content (IPFS blocks) will be host by the pinning service until pin deletion.
246+ Short : `Create a pin by URL` ,
247+ Long : `Will fetch and store the content pointed by the provided URL. The content must be available on the public IPFS network.
248+ The content (IPFS blocks) will be host by the pinning service until pin deletion.
247249From that point, any other IPFS peer can fetch and host your content: Make sure to pin public or encrypted content.
248250Many pin requests (from different users) can target the same CID.
249251A pin is defined by its ID (UUID), its status (queued, pinning, pinned or failed) and target CID.` ,
@@ -298,8 +300,9 @@ A pin is defined by its ID (UUID), its status (queued, pinning, pinned or failed
298300
299301func ipfsPinCreateByCid () * core.Command {
300302 return & core.Command {
301- Short : `Create a pin request. Will fetch and store the content pointed by the provided CID. The content must be available on the public IPFS network` ,
302- Long : `The content (IPFS blocks) will be host by the pinning service until pin deletion.
303+ Short : `Create a pin by CID` ,
304+ Long : `Will fetch and store the content pointed by the provided CID. The content must be available on the public IPFS network.
305+ The content (IPFS blocks) will be host by the pinning service until pin deletion.
303306From that point, any other IPFS peer can fetch and host your content: Make sure to pin public or encrypted content.
304307Many pin requests (from different users) can target the same CID.
305308A pin is defined by its ID (UUID), its status (queued, pinning, pinned or failed) and target CID.` ,
@@ -360,8 +363,8 @@ A pin is defined by its ID (UUID), its status (queued, pinning, pinned or failed
360363
361364func ipfsPinGet () * core.Command {
362365 return & core.Command {
363- Short : `Retrieve information about the provided pin ID (not the CID): status, last modification, CID ` ,
364- Long : `Retrieve information about the provided pin ID (not the CID): status, last modification, CID.` ,
366+ Short : `Get pin information ` ,
367+ Long : `Retrieve information about the provided ** pin ID**, such as status, last modification, and CID.` ,
365368 Namespace : "ipfs" ,
366369 Resource : "pin" ,
367370 Verb : "get" ,
@@ -395,7 +398,7 @@ func ipfsPinGet() *core.Command {
395398
396399func ipfsPinList () * core.Command {
397400 return & core.Command {
398- Short : `Retrieve information about all pins into a volume` ,
401+ Short : `List all pins within a volume` ,
399402 Long : `Retrieve information about all pins into a volume.` ,
400403 Namespace : "ipfs" ,
401404 Resource : "pin" ,
@@ -459,8 +462,9 @@ func ipfsPinList() *core.Command {
459462
460463func ipfsPinDelete () * core.Command {
461464 return & core.Command {
462- Short : `Create an unpin request. If the pin was the last to target a specific CID, the content will be erase from storage` ,
463- Long : `The function is indempotent.` ,
465+ Short : `Create an unpin request` ,
466+ Long : `An unpin request means that you no longer own the content.
467+ This content can therefore be removed and no longer provided on the IPFS network.` ,
464468 Namespace : "ipfs" ,
465469 Resource : "pin" ,
466470 Verb : "delete" ,
0 commit comments