Documentação de APIS - Muito além do Swagger ou Redoc basicões
Nem sempre, um readme.md bem escrito, ou um Swagger UI gerado automaticamente apartir do código, serão suficientes para demonstrar como utilizar suas APIs.
Veja neste excelente curso (provavelmente, o melhor sobre o tema) como criar uma documentação profissional para suas APIs