Comment by dhruv_parmar

I feel most of the times API structures are decided in meetings on whiteboards and it becomes a pain maintaining context across such meetings. Also with remote teams the same process is usually done over email.

Also propagating deprecations/breaking changes to the entire system is also a big pain point.