search

okffi / open-api-definition

Community governed definition of open API
http://okffi.github.io/open-api-definition/
Creative Commons Zero v1.0 Universal
7 stars 7 forks source link

Määritelmän suhde tiedon semanttiikkaan (~sanojen merkitykseen) #37

Open Mygee opened 8 years ago

Mygee commented 8 years ago

Rajapinta käsittelee aina myös tiedon semanttiikaa, eli vapaasti tulkiten sitä, mitä sanoilla tarkoitetaan. Esimerkiksi ajan voi esittää / ymmärtää ainakin 20 erilaisella tavalla tietokannassa. 12/24h, päivämäärän merkintätapa jne.

Semantiikkaa ja metadataa pohtii mm. W3C: https://www.w3.org/TR/dwbp/#context

Tässä ketjussa voi keskustella siitä, miten tiedon semanttiikka pitäisi ottaa huomioon rajapinnan määritelmässä.

apoikola commented 8 years ago

Ollaan tekemässä avoimen rajapinnan määritelmää, eli määrittelemässä sitä, mikä tekee rajapinnasta avoimen. Muutama ohjaava kysymys:

Onko semantiikat seikkoja, jotka muuttavat sitä, onko joku rajapinta avoin vai ei?

On hyvä, jos standardeja merkintätapoja suositaan, mutta jos joku ei halua niitä suosia, vaan tekee avoimen rajapinnan, jonka kautta saa epästandardia kuraa, niin en minä silti rajapinnan avoimuustitteliä lähtisi poistamaan... silloin se olisi vain huono avoin rajapinta.

Voidaanko sallia huonojen avoimien rajapintojen syntyminen?

Riskinä on, että jos niitä on paljon (enemmistö), niin se ei tee hyvää avoimuudelle, eikä määritelmälle, eikä millekään. Toisena riskinä on, että jos ei sallita huonoutta, niin tehdään määritelmästä turhan tiukka, joka karkoittaa käyttäjiä.

Jos semantiikat huomioitaisiin, niin miten se tehtäisiin?

Tämä taisikin olla alkuperäinen kysymys, joten jatkakaa muut tästä :)