Apply suggestions from code review

Co-authored-by: Fabricio Duarte <fabricio.duarte.jr@gmail.com>

Author: Tonitzpp

api/src/main/java/org/apache/cloudstack/api/command/user/resource/ListResourceLimitsCmd.java

@@ -42,7 +42,7 @@ public class ListResourceLimitsCmd extends BaseListProjectAndAccountResourcesCmd
     @Parameter(name = ApiConstants.ID, type = CommandType.LONG, description = "Lists resource limits by ID.")
     private Long id;
 
-    @Parameter(name = ApiConstants.RESOURCE_TYPE, type = CommandType.INTEGER, description = "Type of resource. Values are 0, 1, 2, 3, 4, 6, 7, 8, 9, 10, 11 and 12. "
+    @Parameter(name = ApiConstants.RESOURCE_TYPE, type = CommandType.INTEGER, description = "Type of resource. Accepted values are 0, 1, 2, 3, 4, 6, 7, 8, 9, 10, 11 and 12. "
         + "0 - Instance. Number of Instances a user can create. "
         + "1 - IP. Number of public IP addresses an account can own. "
         + "2 - Volume. Number of disk volumes an account can own. "

api/src/main/java/org/apache/cloudstack/api/command/user/resource/UpdateResourceCountCmd.java

@@ -60,7 +60,7 @@ public class UpdateResourceCountCmd extends BaseCmd {
 
     @Parameter(name = ApiConstants.RESOURCE_TYPE,
                type = CommandType.INTEGER,
-               description = "Type of resource to update. If specifies valid values are 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11 and 12. If not specified will update all resource counts"
+               description = "Type of resource to update. Accepted values are 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11 and 12. If not specified will update all resource counts"
                    + "0 - Instance. Number of Instances a user can create. "
                    + "1 - IP. Number of public IP addresses a user can own. "
                    + "2 - Volume. Number of disk volumes a user can create. "
@@ -73,7 +73,7 @@ public class UpdateResourceCountCmd extends BaseCmd {
                    + "9 - Memory. Total Memory (in MB) a user can use. "
                    + "10 - PrimaryStorage. Total primary storage space (in GiB) a user can use. "
                    + "11 - SecondaryStorage. Total secondary storage space (in GiB) a user can use."
-                   + "12 - InstanceSnapshot. Number of VM snapshots a user can create.")
+                   + "12 - InstanceSnapshot. Number of instance snapshots an account can own.")
     private Integer resourceType;
 
     @Parameter(name = ApiConstants.PROJECT_ID, type = CommandType.UUID, entityType = ProjectResponse.class, description = "Update resource limits for project")

api/src/main/java/org/apache/cloudstack/api/response/AccountResponse.java

@@ -128,15 +128,15 @@ public class AccountResponse extends BaseResponse implements ResourceLimitAndCou
     private String snapshotAvailable;
 
     @SerializedName(ApiConstants.VM_SNAPSHOT_LIMIT)
-    @Param(description = "the number of Instance Snapshots that can be stored by this Account")
+    @Param(description = "The total number of Instance Snapshots that this Account can own")
     private String vmSnapshotLimit;
 
     @SerializedName(ApiConstants.VM_SNAPSHOT_TOTAL)
-    @Param(description = "the number of Instance Snapshots stored by this Account")
+    @Param(description = "The number of Instance Snapshots owned by this Account")
     private Long vmSnapshotTotal;
 
     @SerializedName(ApiConstants.VM_SNAPSHOT_AVAILABLE)
-    @Param(description = "the number of Instance Snapshots available for this Account")
+    @Param(description = "The number of Instance Snapshots available for this Account")
     private String vmSnapshotAvailable;
 
     @SerializedName("templatelimit")