Best practices for generating API documentation?

[neilfrndes]

Would you be able to add a small example to illustrate best practices for creating API documentation for the end user? I currently use drf-yasg to automatically generate an openapi schema and API browser. It works well for standard CRUD endpoints, but gets messy when non standard and nested models are involved.

ps: Thank you for the excellent best practices for startups guide!