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

Turhan toiston poistaminen tilaajan hallitsemaa rajapintaa koskevasta kohdasta #12

Closed smoinen closed 8 years ago

smoinen commented 9 years ago

Määritelmän viimeisessä luvussa (kaksi viimeistä virkettä) on turhaa toistoa.

Alkuperäinen: Tilaajan hallitsema rajapinta tarkoittaa rajapintaa, jota järjestelmän tilaajalla on oikeus käyttää ja levittää haluamallaan tavalla. Tällöin tilaaja voi halutessaan avata rajapinnan järjestelmäntoimittajasta riippumatta, mutta mikäli näin ei tehdä kyse ei ole avoimesta rajapinnasta. Mikäli tilaaja ei avaa rajapintaa, ei rajapinta ole ulkopuolisille avoin, jolloin kyse ei ole yleisesti ottaen avoimesta rajapinnasta.

Muutosehdotus: Tilaajan hallitsema rajapinta tarkoittaa rajapintaa, jota järjestelmän tilaajalla on oikeus käyttää ja levittää haluamallaan tavalla. Tällöin tilaaja voi halutessaan avata rajapinnan järjestelmäntoimittajasta riippumatta. Mikäli näin ei tehdä, ei rajapinta ole ulkopuolisille avoin, jolloin kyse ei ole yleisesti ottaen avoimesta rajapinnasta.

pe3 commented 8 years ago

@smoinen tää olis hyvä saada pull requestiksi. Onnistuisko, että forkkaat tän repon oman käyttäjätunnukses alle, luot siellä feature-branchin muutoksineen ja sitten pull requestin takas tänne päärepoon. Kaiken tän pitäs onnistua selaimessa.

Vai tehdäänkö näin pieni muutos suoraan 1.1-branchiin (jos semmoinen olisi). Jos tehdään kaikki päivitykset issueilla ja featureilla, on ainakin lopuksi helppo kirjoittaa uuden version release notes ja näyttää mikä kaikki on muuttunut. ping @apoikola

Mygee commented 8 years ago

Matin @smoinen kommentti on huomioitu versiossa 1.1.