opengeospatial / om-swg

10 stars 6 forks source link

Capitalization of Terms #184

Closed KathiSchleidt closed 3 months ago

KathiSchleidt commented 2 years ago

Issues with capitalization of terms, pertains to:

**-027 schemas for describing Observations
Does "observations" need to be capitalized here? Please check and modify throughout if necessary.

**-034 Observation
"observation" and "measurement" are written in lowercase letters in this subclause, whereas elsewhere in the document they are capitalized. Please check whether or not these terms require a capital letter at the beginning and harmonize throughout.

**-041 Well, Aquifer and FluidBody
Is it necessary for these terms to be written with capital letters here?

**-042 domain features
Note that at times "domain" is written with a capital letter, and at times not. Please verify which option is correct and harmonize throughout.

**-054 Other examples of Sensors include the human eyes.
Does "sensors" need to have a capital letter here? Please check and harmonize throughout the document.

**-099 Observations, measurements and samples
Previously this has been written with each word capitalized. Please harmonize throughout.

sgrellet commented 2 years ago

My overall rationale would be to capitalize terms that correspond to a class in the model (Ex : Observation, Sample)

With this in mind I would say

KathiSchleidt commented 2 years ago

Makes sense to me!

ilkkarinne commented 2 years ago

-099: please note that the ISO 19156 title is "Geographic information — Observations, measurements and samples". The OGC specification title is "Geographic information — Observations, Measurements and Samples". If I recall correctly, the title was lower-case in the CD Ballot stage by the ISO secretariat.

ilkkarinne commented 2 years ago

Hmm, we seem to have fixed the titles with only the "Observation" word capitalized in the SWG meeting of 9th June 2021: https://github.com/opengeospatial/om-swg/issues/89#issuecomment-857600461

ilkkarinne commented 2 years ago

ISO House Style has a section regarding capitalisation (https://www.iso.org/ISO-house-style.html#iso-hs-s-text-r-s-capitals): "In titles and headings, only the first word is capitalized, except for proper nouns, acronyms or initialisms."

KathiSchleidt commented 2 years ago

So, title is Observations, measurements and samples.

KathiSchleidt commented 2 years ago

Pertaining to 5.2 Conformance classes related to models including Observations, Measurements and Samples Reduce to 5.2 Conformance classes

sgrellet commented 2 years ago

-041 Well, Aquifer and FluidBody

@KathiSchleidt Actually in OGC:GWML2 (https://docs.ogc.org/is/19-013/19-013.html#toc34) class names are prefixed with 'GW_' so that should be GW_Well, GW_Aquifer and GW_FluidBody.

I have searched we have 9 occurrence of Well including this one "EXAMPLE 2b) Some common names for SpatialSample used in various application domains include Borehole, Flightline, Interval, Lidar Cloud, Map Horizon, Microscope Slide, Mine Level, Mine, Observation Well, Profile, Pulp, Quadrat, Scene, Section, ShipsTrack, Spot, Station, Swath, Trajectory, Traverse, etc.." (where everyone starts with a capital letter)

Proposal : In this example, Well, Aquifer and FluidBody are modelled outside the OMS model (in OGC:GWML2 respectively under GW_Well, GW_Aquifer and GW_FluidBody).

To avoid rewriting everything and also the follwing Figures (7 & 8) for non real value added (will just add more complexity for the reader)

KathiSchleidt commented 1 year ago

Added respectively under GW_Well, GW_Aquifer and GW_FluidBody To the text under 7.3.2 Relationship between Sample and domain features. I'll leave the other capitalizations, naively assume that this statement early in the text covers the rest of the capital "Well" etc

sgrellet commented 1 year ago

Agreed