improving swagger docs