iop-alliance / OpenKnowHow

A metadata specification to enable the collection of distributed, standardised metadata of open source hardware designs
GNU General Public License v3.0
2 stars 1 forks source link

[osh-metadata.ttl wikibase review] QU: Component language? (okh:language) #108

Closed addshore closed 3 years ago

addshore commented 3 years ago

https://github.com/OPEN-NEXT/LOSH/blob/master/osh-metadata.ttl#L190-L197

Components have a language? Perhaps the term "language" here just needs to be specified further? I don't see how a physical thing can have a language? Perhaps this refers to something about the component such as the design detail docs etc or something else linked form the compoennt?

moedn commented 3 years ago

Yes, this refers to the language a certain piece of documentation is written in. After all, the only thing we can upload on development platforms is the documentation of components. Even technical drawings often contain descriptions, specifications and instructions. But (usually) languages are not mixed in the same documents which means we can also have unambiguous references to those e.g. for packaging reasons (=a download button for the Japanese version of project crkbd)

So okh:language refers to the language the documentation of a component is written in. This of course

hoijui commented 3 years ago

@addshore Is it now ok? (see commit linked to above)

addshore commented 3 years ago

To me rdfs:label "language" ; still feels unclear.

Personally I think calling it what it is would be clearer, so "Documentation language" or "Primary documentation language" However the comment change in https://github.com/OPEN-NEXT/LOSH/commit/db2ba4b0a334a66cb6d184697ad37287ef162356 is already a good change.

moedn commented 3 years ago

has been renamed to documentationLanguage