Acho que seria interessante e até estimularia a galera a se utilizar mais das APIs se houvesse uma documentação mais explícita e de fácio acesso. Acho que o Swagger 2 (ou OpenAPI 3) serviriam bem. Além de ser uma abordagem legal pra apenas abrir a página e experimentar as requests, é uma maneira bem automatizada de manter a documentação sempre atualizada.

Também há a possibilidade de usar ferramentas como o Read The Docs, mas acho que seria mais trabalhoso.

A lib que eu vi o pessoal mais utilizando é essa aqui: next-swagger-doc. Eu experimentei e não tive problemas

Também tem o Redoc que parece ser interessante e mais bonitinho até ahha A maior vantagem dele é que a interface mobile é bem boa