Escrever documentação é uma atividade normalmente negligenciada em muitos projetos.

Quando o backlog está grande o prazo está curto, normalmente a documentação é uma das primeiras coisas que é cortada do projeto.

Além do mais, muitas pessoas acham que instalar o Swagger é documentar uma API.