Opa, e ai meu nobre.

Acredito que para deixar melhor organizado no atributo description onde você tentou documentar a API por inteiro, você deve apenas dar uma breve descrição do intuito da sua API.

Para detalhar melhor cada endpoint da sua API sugiro que você utilize as anotações de documentação do próprio swagger dentro dos controllers e em cada metodo de acordo com esse link.

Por fim, se você quiser deixar bem mais organizado pode criar interfaces e colocar as anotações do swagger citadas anteriormente nelas e apenas implementa-las nas classes de cada controller que você tiver.