I notice there is quite a bit of variation in the language people have
been using to create glossary entries . Is anyone aware of documented
best practices in how language should be structured when writing a
* Should a description mention the term it describes?
* How long should the description be?
* Is there a style guide for language that should be use?
yes, for our ISO work, we use the ISO Directives, Part 2, Clause 16
and 17. that provides the specific rules for the standards developers
to follow. one of the main ideas for the terminology entry is that the
actual definition could be replaced for each term instance the text of
the standard and it will make sense.
the iso directives are available here as html, and other locations as PDF
for the work in TC211 we cannot deviate from those rules. when i make
comments to the standards developers on the terminology, in the early
stages of the work, a number of comments can be about formatting and
grammar. this is especially true for standards developed else where
that would then "come into the ISO process"
please have a look at the directives and we can talk more.
is the wiki page ready? i had not seen any note about it this week. i
was going to got back through the messages but if i could not find it
i was going to make a google doc page to write some of these things
down or pull them from the messages.
Open Technologies and Geospatial Consultant
M +61 (0) 419 142 254