@cavac @ovid I keep hoping the #IDL-du-jour will save us (#OpenAPI, #ProtocolBuffers, #ApacheThrift, #WSDL, et al) but https://xkcd.com/927 applies and too many projects just slap their half-assed docs online instead of putting in the work for a machine-readable spec