ml-opensource / API-manifesto

Documents how to write APIs
7 stars 5 forks source link

Timeout #30

Closed Casperhr closed 4 years ago

Casperhr commented 4 years ago

@yashmurty / @siemensikkema thanks for the updates. But what about the content, do you agree? do I miss something?

yashmurty commented 4 years ago

@Casperhr Basically LGTM. :+1:

I was wondering if we should say that these numbers(in seconds) apply not to the whole average across all API requests, but some percentile of the slowest API requests, like p95, etc. https://docs.aws.amazon.com/elasticbeanstalk/latest/api/API_Latency.html

But maybe such points can be added in later as people start using the manifesto.

Casperhr commented 4 years ago

It LGTM as a first version. 👍 We can keep iterating it as we move forward. 🙏

agree