OpenAPI is suppose to help with this as well, though I haven't seen alot of good examples in the wild (or where I have worked) where OpenAPI was implemented well or from the start.