@@ -37,16 +37,16 @@ scientific datasets.
3737
3838### Why do we need another library besides the standard reference libraries?
3939
40- Its necessary to have independent implementations of any standard. If you don't have multiple implementations, its
41- easy for the single implementer to mistake the implementation for the actual standard. Its easy to hide problems
40+ It's necessary to have independent implementations of any standard. If you don't have multiple implementations, it's
41+ easy for the single implementer to mistake the implementation for the actual standard. It's easy to hide problems
4242that are actually in the standard by adding work-arounds in the code, instead of documenting problems and creating new
4343versions of the standard with clear fixes. For Netcdf/Hdf, the standard is the file formats, along with their semantic
4444descriptions. The API is language and library specific, and is secondary to the standard.
4545
4646Having multiple implementations is a huge win for the reference library, in that bugs are more quickly found, and
4747ambiguities more quickly identified.
4848
49- ### Whats wrong with the standard reference libraries?
49+ ### What's wrong with the standard reference libraries?
5050
5151The reference libraries are well maintained but complex. They are coded in C, which is a difficult language to master
5252and keep bug free, with implications for memory safety and security. The libraries require various machine and OS dependent
@@ -62,7 +62,7 @@ of programmers, and the need to support legacy APIs.
6262
6363HDF-EOS uses an undocumented "Object Descriptor Language (ODL)" text format, which adds a dependency on the SDP Toolkit
6464and possibly other libraries. These toolkits also provide functionality such as handling projections and coordinate system
65- conversions, and arguably its impossible to process HDF-EOS without them. So the value added here by an independent
65+ conversions, and arguably it's impossible to process HDF-EOS without them. So the value added here by an independent
6666library for data access is less clear. For now, we will provide a "best-effort" to expose the internal
6767contents of the file.
6868
@@ -106,7 +106,7 @@ Our goal is to give read access to all the content in NetCDF, HDF5, HDF4, and HD
106106
107107The library will be thread-safe for reading multiple files concurrently.
108108
109- We are focussing on earth science data, and dont plan to support other uses except as a byproduct.
109+ We are focussing on earth science data, and don't plan to support other uses except as a byproduct.
110110
111111The core module will remain pure Kotlin with very minimal dependencies and no write capabilities. In particular,
112112there will be no dependency on the reference C libraries (except for testing).
@@ -202,7 +202,7 @@ local to the variable they are referenced by.
202202
203203#### Compare with HDF5 data model
204204* Creation order is ignored
205- * We dont include soft (aka symbolic) links in a group, as these point to an existing dataset (variable).
205+ * We don't include soft (aka symbolic) links in a group, as these point to an existing dataset (variable).
206206* Opaque: hdf5 makes arrays of Opaque all the same size, which gives up some of its usefulness. If there's a need,
207207 we will allow Opaque(* ) indicating that the sizes can vary.
208208* Attributes can be of type REFERENCE, with value the full path name of the referenced dataset.
0 commit comments