Finish general cleanup of doc files

Author: jhendersonHDF

DatasetOps/DELETE_Dataset.rst

@@ -51,7 +51,7 @@ An array of links to related resources.  See :doc:`../Hypermedia`.
 Special Errors
 --------------
 
-The implementation of the operation does not return special errors.  For general 
+This implementation of the operation does not return special errors.  For general 
 information on standard error codes, see :doc:`../CommonErrorResponses`.
 
 Examples

DatasetOps/GET_Dataset.rst

@@ -82,7 +82,7 @@ An array of links to related resources.  See :doc:`../Hypermedia`.
 Special Errors
 --------------
 
-The implementation of the operation does not return special errors.  For general 
+This implementation of the operation does not return special errors.  For general 
 information on standard error codes, see :doc:`../CommonErrorResponses`.
 
 Examples

DatasetOps/GET_DatasetShape.rst

@@ -4,7 +4,7 @@ GET Shape
 
 Description
 ===========
-Gets shape of a dataset.
+Gets the shape of a dataset.
 
 Requests
 ========
@@ -50,20 +50,20 @@ A JSON object with the following keys:
 class: A string with one of the following values:
 
  * H5S_NULL: A null dataspace, which has no elements
- * H5S_SCALAR: A dataspace with a single element (although possibly of a complext datatype)
+ * H5S_SCALAR: A dataspace with a single element (although possibly of a complex datatype)
  * H5S_SIMPLE: A dataspace that consists of a regular array of elements
 
 dims: An integer array whose length is equal to the number of dimensions (rank) of the 
-dataspace.  The value of each element gives the the current size of each dimension.  Dims
+dataspace.  The value of each element gives the current size of each dimension.  Dims
 is not returned for H5S_NULL or H5S_SCALAR dataspaces.
 
 maxdims: An integer array whose length is equal to the number of dimensions of the 
 dataspace.  The value of each element gives the maximum size of each dimension. A value
 of 0 indicates that the dimension has *unlimited* extent.  maxdims is not returned for
 H5S_SIMPLE dataspaces which are not extensible or for H5S_NULL or H5S_SCALAR dataspaces.
 
-fillvalue: A value of compatible with the dataset's type, which gives the *fill* value
-for the dataset (the value for which elements will be initialized to when a dataspace
+fillvalue: A value, of a type compatible with the dataset's type, which gives the *fill* value
+for the dataset (the value which elements will be initialized to when a dataspace
 is extended).  fillvalue is only returned for extensible dataspaces.
 
 created
@@ -83,7 +83,7 @@ An array of links to related resources.  See :doc:`../Hypermedia`.
 Special Errors
 --------------
 
-The implementation of the operation does not return special errors.  For general 
+This implementation of the operation does not return special errors.  For general 
 information on standard error codes, see :doc:`../CommonErrorResponses`.
 
 Examples

DatasetOps/GET_DatasetType.rst

@@ -54,7 +54,7 @@ An array of links to related resources.  See :doc:`../Hypermedia`.
 Special Errors
 --------------
 
-The implementation of the operation does not return special errors.  For general 
+This implementation of the operation does not return special errors.  For general 
 information on standard error codes, see :doc:`../CommonErrorResponses`.
 
 Examples

DatasetOps/GET_Datasets.rst

@@ -24,11 +24,11 @@ optional):
 
 Limit
 ^^^^^
-If provided, a positive integer value specifying the maximum number of UUID's to return.
+If provided, a positive integer value specifying the maximum number of UUIDs to return.
 
 Marker
 ^^^^^^
-If provided, a string value indicating that only UUID's that occur after the
+If provided, a string value indicating that only UUIDs that occur after the
 marker value will be returned.
 
 Request Headers
@@ -52,7 +52,7 @@ On success, a JSON response will be returned with the following elements:
 
 datasets
 ^^^^^^^^
-An array of UUID's, one for each dataset in the domain.
+An array of UUIDs, one for each dataset in the domain.
 
 hrefs
 ^^^^^
@@ -61,7 +61,7 @@ An array of links to related resources.  See :doc:`../Hypermedia`.
 Special Errors
 --------------
 
-The implementation of the operation does not return special errors.  For general 
+This implementation of the operation does not return special errors.  For general 
 information on standard error codes, see :doc:`../CommonErrorResponses`.
 
 Examples

DatasetOps/GET_Value.rst

@@ -68,8 +68,8 @@ of "application/octet-stream".  Use this accept value if a binary response is de
 more efficient for large data requests.  If a binary response can be returned, the "Content-Type" response
 header will be "application/octet-stream".  Otherwise the response header will be "json".
 
-Note: Binary responses are only supported for dataset that have a fixed-length type
-(i.e. either a fixed length primitive type or compound type that in turn consists of fixed=length types).  Namely
+Note: Binary responses are only supported for datasets that have a fixed-length type
+(i.e. either a fixed length primitive type or compound type that in turn consists of fixed-length types).  Namely
 variable length strings and variable length data types will always be returned as JSON.
 
 Note: if a binary response is returned, it will consist of the equivalent binary data of the "data" item in the JSON
@@ -98,7 +98,7 @@ dataset region.
 
 index
 ^^^^^
-A list of indexes for each element that met the query condition (only provided when 
+A list of indices for each element that met the query condition (only provided when 
 the query request parameter is used).
 
 hrefs
@@ -108,7 +108,7 @@ An array of links to related resources.  See :doc:`../Hypermedia`.
 Special Errors
 --------------
 
-The implementation of the operation does not return special errors.  For general 
+This implementation of the operation does not return special errors.  For general 
 information on standard error codes, see :doc:`../CommonErrorResponses`.
 
 Examples
@@ -209,7 +209,7 @@ Sample Response - Selection
 Sample Request - Query
 --------------------------
 
-Get elements from dataset where the 'date' field is equal to 20 and the 'temp' field is greater or equal to 70.
+Get elements from dataset where the 'date' field is equal to 20 and the 'temp' field is greater than or equal to 70.
 
 .. code-block:: http
 

DatasetOps/POST_Dataset.rst

@@ -33,7 +33,7 @@ The request body must include a JSON object with a "type" key.  Optionally "shap
 
 type
 ^^^^
-Either a string that is one of the predefined type values, a uuid of a committed type,
+Either a string that is one of the predefined type values, a UUID of a committed type,
 or a JSON object describing the type.  See :doc:`../Types/index` for details of the
 type specification.
 
@@ -49,7 +49,7 @@ dataset has attributes and a type, but will not be able to store any values.
 maxdims
 ^^^^^^^
 An integer array describing the maximum extent of each dimension (or 0 for unlimited
-dimensions).  If maxdims is not provided that resulting dataset will be non-extensible.
+dimensions).  If maxdims is not provided the resulting dataset will be non-extensible.
 Not valid to include if ``H5S_NULL`` is specified for the shape.
 
 creationProperties
@@ -58,12 +58,12 @@ A JSON object that can specify chunk layout, filters, fill value, and other aspe
 See: http://hdf5-json.readthedocs.org/en/latest/bnf/dataset.html#grammar-token-dcpl for a complete 
 description of fields that can be used.
 
-If creationProperties is not provided, default values will be used
+If creationProperties is not provided, default values will be used.
 
 link["id"]
 ^^^^^^^^^^
-The UUID of the group the new group should be linked to.  If the UUID is not valid,
-the request will fail and a new group will not be created.
+The UUID of the group that the new dataset should be linked to.  If the UUID is not valid,
+the request will fail and a new dataset will not be created.
 
 link["name"]
 ^^^^^^^^^^^^
@@ -107,7 +107,7 @@ An array of links to related resources.  See :doc:`../Hypermedia`.
 Special Errors
 --------------
 
-The implementation of the operation does not return special errors.  For general 
+This implementation of the operation does not return special errors.  For general 
 information on standard error codes, see :doc:`../CommonErrorResponses`.
 
 Examples
@@ -272,7 +272,7 @@ Sample Response - Resizable Dataset
 Sample Request - Committed Type
 ----------------------------------
 
-  Create a two-dimensional dataset which uses a committed type with uuid: 
+  Create a two-dimensional dataset which uses a committed type with UUID: 
 
 .. code-block:: http
 

DatasetOps/POST_Value.rst

@@ -4,7 +4,7 @@ POST Value
 
 Description
 ===========
-Gets values of a data for a given point selection (provided in the body of the 
+Gets values of a dataset for a given point selection (provided in the body of the 
 request).
 
 Requests
@@ -58,13 +58,13 @@ On success, a JSON response will be returned with the following elements:
 value
 ^^^^^
 An array of values where the length of the array is equal to the number of points 
-in the request.  Each value will be a string, integer, or JSON object consist
-with the dataset type (e.g. an compound type).
+in the request.  Each value will be a string, integer, or JSON object consistent
+with the dataset type (e.g. a compound type).
 
 Special Errors
 --------------
 
-The implementation of the operation does not return special errors.  For general 
+This implementation of the operation does not return special errors.  For general 
 information on standard error codes, see :doc:`../CommonErrorResponses`.
 
 Examples

DatasetOps/PUT_DatasetShape.rst

@@ -61,7 +61,7 @@ An array of links to related resources.  See :doc:`../Hypermedia`.
 Special Errors
 --------------
 
-The implementation of the operation does not return special errors.  For general 
+This implementation of the operation does not return special errors.  For general 
 information on standard error codes, see :doc:`../CommonErrorResponses`.
 
 Examples

DatasetOps/PUT_Value.rst

@@ -37,7 +37,7 @@ start:
 An optional key that gives the starting coordinate of the selection to be updated.  The
 start value can either be an integer (for 1 dimensional arrays) or an array of integers
 where the length of the array is equal to the number of dimensions of the dataset.  Each
-value must be greater than equal to zero and less than the extent of the corresponding
+value must be greater than or equal to zero and less than the extent of the corresponding
 dimension.
 
 If start is not provided, the selection starts at 0 for each dimension.
@@ -47,22 +47,22 @@ stop:
 An optional key that gives the ending coordinate of the selection to be updated.
 The stop value can either be an integer (for 1 dimensional arrays) or an array of integers
 where the length of the array is equal to the number of dimensions of the dataset.  Each
-value must be greater than equal to start (or zero if start is not provided) and less than
+value must be greater than or equal to start (or zero if start is not provided) and less than
 the extent of the corresponding dimension.
 
 step:
 ^^^^^
 An optional key that gives the step value (i.e. the increment of the coordinate for
 each supplied value). The step value can either be an integer (for 1 dimensional arrays) or
 an array of integers where the length of the array is equal to the number of dimensions of
-the dataset.  Each value must be greater than equal to start (or zero if start is not 
+the dataset.  Each value must be greater than or equal to start (or zero if start is not 
 provided) and less than or equal to the extent of the corresponding dimension.
 
 points:
 ^^^^^^^
 
-An optional key that contains a list of array elements to be updated.  Each element of the list should be an 
-an integer if the dataset is of rank 1 or an n-element list (which n is the dataset rank) is the dataset
+An optional key that contains a list of array elements to be updated.  Each element of the list should be 
+an integer if the dataset is of rank 1 or an n-element list (where n is the dataset rank) if the dataset
 rank is greater than 1.  If points is provided (indicating a point selection update), then start, stop, 
 and step (used for hyperslab selection) should not be provied.
 
@@ -96,7 +96,7 @@ No response elements are returned.
 Special Errors
 --------------
 
-The implementation of the operation does not return special errors.  For general 
+This implementation of the operation does not return special errors.  For general 
 information on standard error codes, see :doc:`../CommonErrorResponses`.
 
 Examples
@@ -106,7 +106,7 @@ Examples
 Sample Request
 --------------
 
-This example writes a 10x10 integer datasets with the values 0-99 inclusive.
+This example writes a 10x10 integer dataset with the values 0-99 inclusive.
 
 .. code-block:: http