[andreasklinger]

Imho it matters less.

What's important is that you have rigorous testing around your API.

APIs are essentially external contracts people build against. You don't want to break this contract.

make sure it

- never changes unless you know about it

- updates the documentation whenever it changes