Minimize/harmonise talk about "entities" in primer

[acka47]

This was a topic in today's usage board meeting. If I understood correctly, @tombaker was asking for some description of how such terminology as "entity" is used and @kcoyle responded that she hopes this term does not come up at all in the spec and it does not in the vocab.

But "entity" appears four times in the OpenWEMI primer, twice in the connection "entity type" where "entity" refers to those resources that are typed as OpenWEMI classes and one time referring to the classes endeavor, work, expression, manifestation, item themselves.

It will definitely make the primer more accessible to minimize the use of this term or at least constrain its use to the WEMI classes or resources typed as such.

[kcoyle]

The first use of "entity" is about FRBR, and FRBR does call them entities. I think we should leave that one, but find some other wording for the remaining ones. I know that we spend some effort in the DCTAP group to purge that model of the "entity" term, and we should do the same here. The hard part is: what term can we use? There might be some places where we can use "class" but ... not all. Since we can't add comments to github documents we can do this as a pull request where we can see the diff.

[acka47]

Since we can't add comments to github documents we can do this as a pull request where we can see the diff.

I did already open a PR at #91.

The hard part is: what term can we use?

I went with "abstraction levels" and – taking from the vocab itself – "endeavor" in #91.

[tombaker]

On a lighter note, Occam's razor - "the problem-solving principle that recommends searching for explanations constructed with the smallest possible set of elements" attributed to William of Ockham, a fourteen-century English philosopher - was widely paraphrased as "Entia non sunt multiplicanda praeter necessitatem" ("Entities must not be multiplied beyond necessity"). I'm sure he didn't have WEMI in mind, though I did when I happened to read these words.

[kcoyle]

Changes made to document as per working group decisions.

[acka47]

Thanks!