Comment by torben-friis

I mean, you're not creating the api from thin air as you write code right? Usually you'd have some larger doc about the project with the design you can point to.