News for hackers. Stuff that matters.
Re:UK Government Guidelines on Documenting APIs by moaf on Sunday May 22, 2022 @09:03AM (#31467719)
> 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.

There are no comments on this comment yet.