Documentation written by hand is a copy of the implementation, and copies drift — usually within a sprint, and always without anybody noticing. The annotations are verbose and…
The documentation was written in January and the API changed in March. Documentation written by hand is a copy, and copies drift — usually within a sprint.
A limit with no feedback means a well-behaved client cannot behave well — it finds out by being refused, and its only strategy is to retry. Retry-After is…
An interface with every field optional describes what a response might contain and lets the compiler agree that a success field exists on an error. The narrowing is…
Adding a computed field to a REST response by filtering the prepared object works and leaves the field undocumented, so nothing but your own client knows it exists.…
3.0 brought a JSON serialiser into the framework, and it is stricter than the third-party one it replaces in ways that break existing code quietly. Case-sensitive deserialisation is…
A limit with no feedback means a well-behaved client cannot behave well — it finds out by being refused, and its only strategy is to retry. Retry-After is…