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

Add mention about throttling (rate limiting) #21

Closed aapris closed 8 years ago

aapris commented 8 years ago

@pe3:n pyynnöstä. :) Mutta tarvitaanko tällaisen featuren tekemiseen vielä feature-branch, eikö riitä että forkkaan alkuperäisen repon, teen muutoksen forkkiin ja sitten pull requestin? Nuketan kuitenkin tämän forkin heti kun pull request on hyväksytty tai joka tapauksessa jonkun ajan päästä pois roikkumasta. Jos teen uusia muutoksia, niin voin forkata aina päärepon uudestaan.

pe3 commented 8 years ago

Musta nää pull-requestit on aika hyviä, kun en itse ainakaan tiedä päätöksistä, mihin suuntaa määritelmää ollaan viemässä ja mitkä projektin askelmerkit on. Voitas omistaa issue #11 tästä "featuresta" keskustelemiseen/päättämiseen.

pe3 commented 8 years ago

@aapris keskustelua prosessista FB:ssä. Pääpointti siis, että määritelmä on jo käytössä, eikä sitä voi hallitsemattomasti muuttaa.

d2s commented 8 years ago

Näkisin järkevänä että muutosvaiheessa oleva (laajennettu) API-määritys versioidaan uudella versionumerolla ja -päivämäärällä.

Esim. näin:

Versio: 1.1 (non-finished beta version)