I think there is some confusion here.

What i meant was applications should be self documenting, something like swagger comes to my mind.