Encourage your API designers to use this approach to not only add documentation in the main body of an API design, but also in any libraries you use. There’s a lot to like in Cadl.