> Should we maintain "intuitive" end-user documentation separately? The answer is a resounding “yes”. Definitions are an important part of API documentation, b

> Should we maintain "intuitive" end-user documentation separately? The answer is a resounding “yes”. Definitions are an important part of API documentation, but user guides and tutorials are equally important if you really want to empower developers. OAS really doesn’t support much additional information outside of definitions and simple descriptions, so complimentary documentation is often needed.