search

openknowledgebe / open-education

Website for Open Education (working group)
MIT License
3 stars 0 forks source link

[API] Incorrect use of “representation” #10

Open RubenVerborgh opened 7 years ago

RubenVerborgh commented 7 years ago

The API documentation describes subjects as "Subjects are representations of a subject". This is terminologically incorrect; subject are subjects, not representations; i.e., http://example.org/subjects/Mathematics identifies the concept of maths, not a representation of the concept.

A correct (and less tautological) way to describe things would be "A subject is a branch of knowledge studied or taught in an educational institution". Similar for other properties.

jhoobergs commented 7 years ago

Indeed, I changed this from something else and now it doesn't really mean anything anymore. I'll fix it.